Oxyscripts - PHP Development, tutorials, articles, news, programming, scripts and forums.

GtkTooltips

Adds tooltips to other widgets.

Object Hierarchy

GtkObject
`-- GtkData
`-- GtkTooltips

Direct subclasses

None.

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 set via the set_tip() method.

They are especially helpful for adding more verbose descriptions of things such as buttons in a toolbar.

This widget holds tooltips for other widgets. You should only need one Tooltip widget for all widgets you wish to add tips to.

Tooltips can only be used on widgets which have their own x window. Other widgets, e.g. GtkLabels can be added to an GtkEventBox to benefit from tooltips.

A widget which wants to use a tooltip needs to expose GDK_ENTER_NOTIFY_MASK and GDK_LEAVE_NOTIFY_MASK which can be set via the add_events() function. Most widgets do this automatically, but e.g. a GtkDrawingArea does not.

Constructor

GtkTooltips (void);
-- Creates a new tooltips instance.

Methods

enable()
Actives the showing of tooltips.
disable()
Disable the showing of tooltips.
set_delay()
Determines the time after which the tooltips are shown
set_tip()
Sets the tooltip for a specific widget
set_colors()
Sets the fore- and background color of the tooltips. Deprecated.
force_window()
Used internally only.