gtk.Tooltips add tips to your widgets. Synopsis gtk.Tooltips gtk.Object gtk.Tooltips enable disable set_tip widget tip_text tip_privateNone force_window Functions gtk.tooltips_data_get widget Ancestry +-- gobject.GObject +-- gtk.Object +-- gtk.Tooltips gtk.Tooltips Properties gtk.Object Properties Attributes
"tip_window" Read The window that the tooltip is displayed in. "tip_label" Read The label that displays the tooltip text. "active_tips_data" Read The data associated with the active tooltip. "tips_data_list" Read A list containing the data associated with the tooltips in a tooltips group. For each tooltip the data is a tuple containing: the tooltip object, the associated widget, the tooltip text and the tooltip private text. "delay" Read The delay between the mouse pausing over the widget and the display of the tooltip in msec. "enabled" Read If True the tooltips are enabled "use_sticky_delay" Read If True shorten the delay for showing a tooltip on another widget is already showing a tooltip. "timer_tag" Read The tag of the timeout handler used for the delay.
gtk.Tooltips Signal Prototypes gobject.GObject Signal Prototypes gtk.Object Signal Prototypes Description This method is deprecated in PyGTK 2.12 and above 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 the gtk.Tooltips() constructor. Every tooltip in the group can then be turned off with a call to the disable() method and enabled with the enable() method. To assign a tip to a particular gtk.Widget, use the set_tip() method. Tooltips can only be set on widgets which have their own X window. To check if a widget has its own window use widget.flags()&gtk.NO_WINDOW. To add a tooltip to a widget that doesn't have its own window, place the widget inside a gtk.EventBox and add a tooltip to the eventbox instead. The default appearance of all tooltips in a program is determined by the current theme that the user has selected. Information about the tooltip (if any) associated with an arbitrary widget can be retrieved using the gtk.tooltips_data_get() function. Constructor gtk.Tooltips Returns : a new gtk.Tooltips object This method is deprecated in PyGTK 2.12 and above Creates an empty gtk.Tooltips group. Methods gtk.Tooltips.enable enable This method is deprecated in PyGTK 2.12 and above The enable() method enables a group of tooltips. A tooltip will be displayed over its associated widget when the mouse pointer pauses over the widget. gtk.Tooltips.disable disable This method is deprecated in PyGTK 2.12 and above The disable() method disables a group of tooltips. A tooltip will not be displayed over its associated widget when the mouse pointer pauses over the widget. gtk.Tooltips.set_tip set_tip widget tip_text tip_privateNone widget : a gtk.Widget tip_text : the tooltip text tip_private : the tooltip private text for context sensitive display This method is deprecated in PyGTK 2.12 and above The set_tips() method creates a tooltip for the specified widget. The text specified by tooltip_text will be displayed when the mouse pointer pauses over widget if the tooltips are enabled.. gtk.Tooltips.force_window force_window This method is deprecated in PyGTK 2.12 and above The force_window() method ensures that the window used for displaying the given tooltips is created. Applications should never have to call this function, since PyGTK takes care of this. Functions gtk.tooltips_data_get gtk.tooltips_data_get widget widget : a widget Returns : a tuple containing the tooltip data associated with widget or None This method is deprecated in PyGTK 2.12 and above The gtk.tooltips_data_get() function returns a tuple containing the tooltip data associated with widget. The tuple contains: the gtk.Tooltips group containing the tooltip the widget the tooltip text string the tooltip private text string or None If widget does not have an associated tooltip this function returns None.