GtkTooltips {RGtk2}R Documentation

GtkTooltips

Description

Add tips to your widgets

Methods and Functions

gtkTooltipsNew()
gtkTooltipsEnable(object)
gtkTooltipsDisable(object)
gtkTooltipsSetDelay(object, delay)
gtkTooltipsSetTip(object, widget, tip.text = NULL, tip.private = NULL)
gtkTooltipsDataGet(widget)
gtkTooltipsForceWindow(object)
gtkTooltipsGetInfoFromTipWindow(object)
gtkTooltips()

Hierarchy

  GObject
   +----GtkObject
         +----GtkTooltips

Detailed Description

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 gtk\Widget\No\Window(). 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.

# 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."))

Structures

GtkTooltips
Holds information about a group of tooltips. Fields should be changed using the functions provided, rather than directly accessing the struct's members.

GtkTooltipsData
tooltips is the GtkTooltips group that this tooltip belongs to. widget is the GtkWidget that this tooltip data is associated with. tip_text is a string containing the tooltip message itself. tip_private is a string that is not shown as the default tooltip. Instead, this message may be more informative and go towards forming a context-sensitive help system for your application. (FIXME: how to actually "switch on" private tips?)

Convenient Construction

gtkTooltips is the equivalent of gtkTooltipsNew.

Author(s)

Derived by RGtkGen from GTK+ documentation

References

http://developer.gnome.org/doc/API/2.0/gtk/GtkTooltips.html


[Package RGtk2 version 2.8.6 Index]