![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkTipsQuery; GtkWidget* gtk_tips_query_new (void); void gtk_tips_query_start_query (GtkTipsQuery *tips_query); void gtk_tips_query_stop_query (GtkTipsQuery *tips_query); void gtk_tips_query_set_caller (GtkTipsQuery *tips_query, GtkWidget *caller); void gtk_tips_query_set_labels (GtkTipsQuery *tips_query, const gchar *label_inactive, const gchar *label_no_tip);
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 gtk_tips_query_start_query()
, 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 gtk_tips_query_stop_query()
must be made in order to
stop the query and return the interface to its normal state.
The gtk_tips_query_set_caller()
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).
typedef struct { GtkLabel label; guint emit_always : 1; guint in_query : 1; gchar *label_inactive; gchar *label_no_tip; GtkWidget *caller; GtkWidget *last_crossed; GdkCursor *query_cursor; } GtkTipsQuery;
GtkTipsQuery
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.
GtkWidget* gtk_tips_query_new (void);
gtk_tips_query_new
is deprecated and should not be used in newly-written code.
Creates a new GtkTipsQuery.
Returns : |
a new GtkTipsQuery. |
void gtk_tips_query_start_query (GtkTipsQuery *tips_query);
gtk_tips_query_start_query
is deprecated and should not be used in newly-written code.
Starts a query. The GtkTipsQuery widget will take control of the mouse and as the mouse moves it will display the tooltip of the widget beneath the mouse.
|
a GtkTipsQuery. |
void gtk_tips_query_stop_query (GtkTipsQuery *tips_query);
gtk_tips_query_stop_query
is deprecated and should not be used in newly-written code.
Stops a query.
|
a GtkTipsQuery. |
void gtk_tips_query_set_caller (GtkTipsQuery *tips_query, GtkWidget *caller);
gtk_tips_query_set_caller
is deprecated and should not be used in newly-written code.
Sets the widget which initiates the query, usually a button.
If the caller
is selected while the query is running, the query is
automatically stopped.
|
a GtkTipsQuery. |
|
the widget which initiates the query. |
void gtk_tips_query_set_labels (GtkTipsQuery *tips_query, const gchar *label_inactive, const gchar *label_no_tip);
gtk_tips_query_set_labels
is deprecated and should not be used in newly-written code.
Sets the text to display when the query is not in effect, and the text to display when the query is in effect but the widget beneath the pointer has no tooltip.
|
a GtkTipsQuery. |
|
the text to display when the query is not running. |
|
the text to display when the query is running but the widget beneath the pointer has no tooltip. |