tk2ico {tcltk2}R Documentation

Manipulate icons under Windows

Description

These function are only useful for Windows, but they can be used without error on other platform for making platform-independent code that has an additional behaviour under Windows. On the other platforms, these function just return NULL silently.

Usage

tk2ico.load(file = "shell32.dll", res = "application")
tk2ico.create(iconfile)
tk2ico.destroy(icon)
tk2ico.hicon(icon)
tk2ico.info(icon, convert = TRUE)
tk2ico.set(win, icon, pos = NULL, type = c("all", "small", "big"))
tk2ico.text(icon)
tk2ico.text(icon) <- value
tk2ico.pos(icon) <- value
tk2ico.taskbar.add(icon, pos = 0, text = tk2ico.text(icon),
    leftmenu = NULL, rightmenu = NULL)
tk2ico.taskbar.delete(icon)
tk2ico.taskbar.modify(icon, pos = NULL, text = NULL)

Arguments

file A file having icon resources (.exe, or .dll)
res The name of the resource from where the icon should be extracted
iconfile A file with a .ico extension, containing one or more Windows icons
icon An icon object
convert Do we convert the result into a data.frame?
win A tk window, or an integer representing the handle (HWND) of a foreign window whose icon will be changed (take care, the function returns TRUE even if the handle is wrong!
pos A position (starting from 0) pointing to an icon in a multi-icon object. Note that pos is not used in tk2ico.set() if type = "all" (in this case, best icons matching both "small" and "large" sizes are searched in the icon resource
type Do we change only the small, the large, or both icons?
value A string with the new text for the icon in tk2ico.text() or a numerical value indicating the new default position in the icon resource for tk2ico.pos()
text Change a text for an icon
leftmenu A "tkwin" object to display when the user left-clicks on the taskbar icon (usually, a Tk popup menu), or NULL for nothing
rightmenu Idem as 'lefmenu' but for a right-click on the taskbar icon

Value

These function do nothing and return NULL on other platforms than Windows.

Author(s)

Philippe Grosjean


[Package tcltk2 version 1.0-7.1 Index]