Learn R Programming
svWidgets (version 0.9-40)

tkTool: Conveniently manipulate Tk toolbars

Description

These functions provide an easy way to create and manipulate Tk toolbars under R. Note that the corresponding ToolXXX() function also manipulate Tk toolbars the same way, but are capable of manipulating other toolbars as well (not currently, but that could be implemented in the future). One should, thus, preferably use ToolXXX()!

Usage

tkToolAdd(toolbar, side = "top")
  tkToolAddItem(toolbar, item, action, image = "", options = "")
  tkToolDel(toolbar)
  tkToolDelItem(toolbar, item)
  tkToolItems(toolbar)
  tkToolChangeItem(toolbar, item, action = "", options = "")
  tkToolStateItem(toolbar, item, active = TRUE)
  tkToolInvoke(toolbar, item)

Arguments

toolbar
Name of a Tk toolbar
side
Where to place the toolbar in the window ("top", "bottom", "left", or "right")?
item
Name of a toolbutton
action
Action the toolbutton triggers (R code)
image
Name of a Tk image to display in the toolbutton
options
Additional options, for instance 'state = "disable"' to disable the toolbutton at creation.
active
Do we enable or disable the toolbutton?

Value

  • tkToolAdd() and tkToolAddItem() return the handle of the newly created toolbar or toolbutton invisibly. tkToolDel() and tkToolDelItem() return invisibly TRUE if the resource is found and deleted, FALSE otherwise. tkToolItems() returns the list of all items in a given toolbar. tkToolInvoke() returns invisibly TRUE if the toolbutton was invoked, FALSE otherwise. tkToolStateItem() returns the new state of the toolbutton.

Details

Do not use these functions directly. Prefer the corresponding ToolXXX() functions that will call them if Tk toolbars or toolbutton are provided.

See Also

ToolAdd