gtk-0.12.4: Binding to the Gtk+ graphical user interface library.

Portabilityportable (depends on GHC)
Stabilityprovisional
Maintainergtk2hs-users@lists.sourceforge.net
Safe HaskellNone

Graphics.UI.Gtk.Misc.Tooltips

Contents

Description

Add tips to your widgets

Synopsis

Detail

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 tooltipsNew. Every tooltip in the group can then be turned off with a call to tooltipsDisable and enabled with tooltipsEnable.

Class Hierarchy

 | GObject
 | +----Object
 | +----Tooltips

Types

Constructors

tooltipsNew :: IO TooltipsSource

Create a new goup of Tooltips.

Methods

tooltipsEnable :: TooltipsClass self => self -> IO ()Source

Allows the user to see your tooltips as they navigate your application.

tooltipsDisable :: TooltipsClass self => self -> IO ()Source

Causes all tooltips in tooltips to become inactive. Any widgets that have tips associated with that group will no longer display their tips until they are enabled again with tooltipsEnable.

tooltipsSetDelaySource

Arguments

:: TooltipsClass self 
=> self 
-> Int

delay - the delay in milliseconds

-> IO () 

Sets the time between the user moving the mouse over a widget and the widget's tooltip appearing.

  • Warning: this function is deprecated and should not be used in newly-written code.

tooltipsSetTipSource

Arguments

:: (TooltipsClass self, WidgetClass widget) 
=> self 
-> widget

widget - the Widget you wish to associate the tip with.

-> String

tipText - a string containing the tip itself.

-> String

tipPrivate - a string of any further information that may be useful if the user gets stuck.

-> IO () 

Adds a tooltip containing the message tipText to the specified Widget.

tooltipsDataGet :: WidgetClass w => w -> IO (Maybe (Tooltips, String, String))Source

Retrieves any Tooltips previously associated with the given widget.