| GtkTipsQuery {RGtk2} | R Documentation |
Displays help about widgets in the user interface
gtkTipsQueryNew(show = TRUE)
gtkTipsQueryStartQuery(object)
gtkTipsQueryStopQuery(object)
gtkTipsQuerySetCaller(object, caller)
gtkTipsQuerySetLabels(object, label.inactive, label.no.tip)
gtkTipsQuery(show = TRUE)
GObject
+----GInitiallyUnowned
+----GtkObject
+----GtkWidget
+----GtkMisc
+----GtkLabel
+----GtkTipsQuery
GtkTipsQuery implements
AtkImplementorIface and GtkBuildable.
The GtkTipsQuery widget is a subclass of GtkLabel which is used to display
help about widgets in a user interface.
A query is started with a call to gtkTipsQueryStartQuery, usually
when some kind of 'Help' button is pressed. The GtkTipsQuery then grabs all
events, stopping the user interface from functioning normally.
Then as the user moves the mouse over the widgets, the GtkTipsQuery displays
each widget's tooltip text.
By connecting to the "widget-entered" or "widget-selected" signals, it is
possible to customize the GtkTipsQuery to perform other actions when widgets
are entered or selected. For example, a help browser could be opened with
documentation on the widget selected.
At some point a call to gtkTipsQueryStopQuery must be made in order to
stop the query and return the interface to its normal state.
The gtkTipsQuerySetCaller function can be used to specify a widget
which the user can select to stop the query (often the same button used to
start the query).
GtkTipsQueryGtkTipsQuery is deprecated and should not be used in newly-written code.
The GtkTipsQuery struct contains private data only, and
should be accessed using the functions below.
gtkTipsQuery is the equivalent of gtkTipsQueryNew.
start-query(tipsquery, user.data)tipsqueryGtkTipsQuery] the object which received the signal.user.data
stop-query(tipsquery, user.data)tipsqueryGtkTipsQuery] the object which received the signal.user.data
widget-entered(tipsquery, widget, tip.text, tip.private, user.data)tipsqueryGtkTipsQuery] the object which received the signal.widgetGtkWidget] the widget that was entered by the pointer.tip.texttip.privategtkTooltipsSetTip).user.data
widget-selected(tipsquery, widget, tip.text, tip.private, event, user.data)tipsqueryGtkTipsQuery] the object which received the signal.widgetGtkWidget] the widget that was selected.tip.texttip.privategtkTooltipsSetTip).eventGdkEventButton] the button press or button release event.user.data
Returns: [logical] TRUE if the query should be stopped.
caller [GtkWidget : Read / Write]The widget that starts the tips query, usually a button. If it is selected while the query is in effect the query is automatically stopped.
emit-always [logical : Read / Write]
TRUE if the widget-entered and widget-selected signals are emitted even when
the widget has no tooltip set.
Default value: FALSE
label-inactive [character : Read / Write]
The text to display in the GtkTipsQuery widget when the query is not in
effect.
Default value: NULL
label-no-tip [character : Read / Write]
The text to display in the GtkTipsQuery widget when the query is running
and the widget that the pointer is over has no tooltip.
Default value: NULL
Derived by RGtkGen from GTK+ documentation
http://developer.gnome.org/doc/API/2.0/gtk/GtkTipsQuery.html