GtkTooltips
has been deprecated in GTK+ 2.12, in favor of the new
GtkTooltip
API. Tooltips are the messages that appear next to a widget when the mouse pointer is held over it for a short amount of time. They are especially helpful for adding more verbose descriptions of things such as buttons in a toolbar. An individual tooltip belongs to a group of tooltips. A group is created with a call to gtkTooltipsNew
. Every tooltip in the group can then be turned off with a call to gtkTooltipsDisable
and enabled with gtkTooltipsEnable
. The length of time the user must keep the mouse over a widget before the tip is shown, can be altered with gtkTooltipsSetDelay
. This is set on a 'per group of tooltips' basis. To assign a tip to a particular GtkWidget
, gtkTooltipsSetTip
is used.
PLEASE NOTE: Tooltips can only be set on widgets which have their own X window and
receive enter and leave events.
To check if a widget has its own window use gtkWidgetNoWindow()
.
To add a tooltip to a widget that doesn't have its own window, place the
widget inside a GtkEventBox
and add a tooltip to that instead.
The default appearance of all tooltips in a program is determined by the current GTK+ theme that the user has selected. Information about the tooltip (if any) associated with an arbitrary widget can be retrieved using gtkTooltipsDataGet
. Adding tooltips to buttons.
## Let's add some tooltips to some buttons
button_bar_tips <- gtkTooltips() ## Create the buttons and pack them into a GtkHBox
hbox <- gtkHBox(TRUE, 2) load_button <- gtkButton("Load a file")
hbox$packStart(load_button, TRUE, TRUE, 2) save_button <- gtkButton("Save a file")
hbox$packStart(save_button, TRUE, TRUE, 2) ## Add the tips
button_bar_tips$setTip(load_button,
"Load a new document into this window",
paste("Requests the filename of a document.",
"This will then be loaded into the current",
"window, replacing the contents of whatever",
"is already loaded."))
button_bar_tips$setTip(save_button,
"Saves the current document to a file",
paste("If you have saved the document previously,",
"then the new version will be saved over the",
"old one. Otherwise, you will be prompted for",
"a filename."))