📄 gtktipsquery.html
字号:
<HTML><HEAD><TITLE>GtkTipsQuery</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="PREVIOUS"TITLE="GtkText"HREF="gtktext.html"><LINKREL="NEXT"TITLE="GtkToggleButton"HREF="gtktogglebutton.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtktext.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtktogglebutton.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKTIPSQUERY">GtkTipsQuery</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN41057"></A><H2>Name</H2>GtkTipsQuery -- displays help about widgets in the user interface.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN41060"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtktipsquery.html#GTKTIPSQUERY-STRUCT">GtkTipsQuery</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktipsquery.html#GTK-TIPS-QUERY-NEW">gtk_tips_query_new</A> (void);void <AHREF="gtktipsquery.html#GTK-TIPS-QUERY-START-QUERY">gtk_tips_query_start_query</A> (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tips_query);void <AHREF="gtktipsquery.html#GTK-TIPS-QUERY-STOP-QUERY">gtk_tips_query_stop_query</A> (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tips_query);void <AHREF="gtktipsquery.html#GTK-TIPS-QUERY-SET-CALLER">gtk_tips_query_set_caller</A> (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tips_query, <AHREF="gtkwidget.html">GtkWidget</A> *caller);void <AHREF="gtktipsquery.html#GTK-TIPS-QUERY-SET-LABELS">gtk_tips_query_set_labels</A> (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tips_query, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label_inactive, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label_no_tip); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41077"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkwidget.html">GtkWidget</A> +----<AHREF="gtkmisc.html">GtkMisc</A> +----<AHREF="gtklabel.html">GtkLabel</A> +----GtkTipsQuery</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41084"></A><H2>Args</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtktipsquery.html#GTKTIPSQUERY--EMIT-ALWAYS">emit-always</A>" <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> : Read / Write "<AHREF="gtktipsquery.html#GTKTIPSQUERY--CALLER">caller</A>" <AHREF="gtkwidget.html">GtkWidget</A> : Read / Write "<AHREF="gtktipsquery.html#GTKTIPSQUERY--LABEL-INACTIVE">label-inactive</A>" <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>* : Read / Write "<AHREF="gtktipsquery.html#GTKTIPSQUERY--LABEL-NO-TIP">label-no-tip</A>" <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>* : Read / Write</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41095"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtktipsquery.html#GTKTIPSQUERY-START-QUERY">start-query</A>" void user_function (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tipsquery, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtktipsquery.html#GTKTIPSQUERY-STOP-QUERY">stop-query</A>" void user_function (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tipsquery, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtktipsquery.html#GTKTIPSQUERY-WIDGET-ENTERED">widget-entered</A>" void user_function (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tipsquery, <AHREF="gtkwidget.html">GtkWidget</A> *widget, <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *tip_text, <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *tip_private, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtktipsquery.html#GTKTIPSQUERY-WIDGET-SELECTED">widget-selected</A>" <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> user_function (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tipsquery, <AHREF="gtkwidget.html">GtkWidget</A> *widget, <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *tip_text, <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *tip_private, <AHREF=../gdk/gdk-event-structures.html#GDKEVENTBUTTON>GdkEventButton</A> *event, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41118"></A><H2>Description</H2><P>The <AHREF="gtktipsquery.html">GtkTipsQuery</A> widget is a subclass of <AHREF="gtklabel.html">GtkLabel</A> which is used to displayhelp about widgets in a user interface.</P><P>A query is started with a call to <AHREF="gtktipsquery.html#GTK-TIPS-QUERY-START-QUERY">gtk_tips_query_start_query</A>(), usuallywhen some kind of 'Help' button is pressed. The <AHREF="gtktipsquery.html">GtkTipsQuery</A> then grabs allevents, stopping the user interface from functioning normally.Then as the user moves the mouse over the widgets, the <AHREF="gtktipsquery.html">GtkTipsQuery</A> displayseach widget's tooltip text.</P><P>By connecting to the "widget-entered" or "widget-selected" signals, it ispossible to customize the <AHREF="gtktipsquery.html">GtkTipsQuery</A> to perform other actions when widgetsare entered or selected. For example, a help browser could be opened withdocumentation on the widget selected.</P><P>At some point a call to <AHREF="gtktipsquery.html#GTK-TIPS-QUERY-STOP-QUERY">gtk_tips_query_stop_query</A>() must be made in order tostop the query and return the interface to its normal state.The <AHREF="gtktipsquery.html#GTK-TIPS-QUERY-SET-CALLER">gtk_tips_query_set_caller</A>() function can be used to specify a widgetwhich the user can select to stop the query (often the same button used tostart the query).</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41132"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN41134"></A><H3><ANAME="GTKTIPSQUERY-STRUCT"></A>struct GtkTipsQuery</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkTipsQuery;</PRE></TD></TR></TABLE><P>The <AHREF="gtktipsquery.html#GTKTIPSQUERY-STRUCT">GtkTipsQuery</A> struct contains private data only, andshould be accessed using the functions below.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41140"></A><H3><ANAME="GTK-TIPS-QUERY-NEW"></A>gtk_tips_query_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_tips_query_new (void);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtktipsquery.html">GtkTipsQuery</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN41147"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a new <AHREF="gtktipsquery.html">GtkTipsQuery</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41157"></A><H3><ANAME="GTK-TIPS-QUERY-START-QUERY"></A>gtk_tips_query_start_query ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_tips_query_start_query (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tips_query);</PRE></TD></TR></TABLE><P>Starts a query.The <AHREF="gtktipsquery.html">GtkTipsQuery</A> widget will take control of the mouse and as the mousemoves it will display the tooltip of the widget beneath the mouse.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN41164"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>tips_query</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtktipsquery.html">GtkTipsQuery</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41174"></A><H3><ANAME="GTK-TIPS-QUERY-STOP-QUERY"></A>gtk_tips_query_stop_query ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_tips_query_stop_query (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tips_query);</PRE></TD></TR></TABLE><P>Stops a query.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN41180"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>tips_query</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtktipsquery.html">GtkTipsQuery</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41190"></A><H3><ANAME="GTK-TIPS-QUERY-SET-CALLER"></A>gtk_tips_query_set_caller ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_tips_query_set_caller (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tips_query, <AHREF="gtkwidget.html">GtkWidget</A> *caller);</PRE></TD></TR></TABLE><P>Sets the widget which initiates the query, usually a button.If the <TTCLASS="PARAMETER"><I>caller</I></TT> is selected while the query is running, the query isautomatically stopped.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN41198"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>tips_query</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtktipsquery.html">GtkTipsQuery</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>caller</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the widget which initiates the query. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41212"></A><H3><ANAME="GTK-TIPS-QUERY-SET-LABELS"></A>gtk_tips_query_set_labels ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_tips_query_set_labels (<AHREF="gtktipsquery.html">GtkTipsQuery</A> *tips_query, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label_inactive, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label_no_tip);</PRE></TD></TR⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -