gtktipsquery.html

最新gtk中文资料集

<td><p><span class="term"><em class="parameter"><code>caller</code></em>&#160;:</span></p></td>
<td>the widget which initiates the query.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4591174"></a><h3>
<a name="gtk-tips-query-set-labels"></a>gtk_tips_query_set_labels ()</h3>
<a class="indexterm" name="id4591190"></a><pre class="programlisting">void                gtk_tips_query_set_labels           (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tips_query,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *label_inactive,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *label_no_tip);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_set_labels</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
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.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tips_query</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>label_inactive</code></em>&#160;:</span></p></td>
<td>the text to display when the query is not running.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>label_no_tip</code></em>&#160;:</span></p></td>
<td>the text to display when the query is running but the widget
beneath the pointer has no tooltip.


</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4591307"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id4591318"></a><h3>
<a name="GtkTipsQuery--caller"></a>The <code class="literal">"caller"</code> property</h3>
<a class="indexterm" name="id4591334"></a><pre class="programlisting">  "caller"                   <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>             : Read / Write</pre>
<p>
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.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4591360"></a><h3>
<a name="GtkTipsQuery--emit-always"></a>The <code class="literal">"emit-always"</code> property</h3>
<a class="indexterm" name="id4591376"></a><pre class="programlisting">  "emit-always"              <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>
<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the widget-entered and widget-selected signals are emitted even when
the widget has no tooltip set.
</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4591414"></a><h3>
<a name="GtkTipsQuery--label-inactive"></a>The <code class="literal">"label-inactive"</code> property</h3>
<a class="indexterm" name="id4591431"></a><pre class="programlisting">  "label-inactive"           <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write</pre>
<p>
The text to display in the <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> widget when the query is not in
effect.
</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4591466"></a><h3>
<a name="GtkTipsQuery--label-no-tip"></a>The <code class="literal">"label-no-tip"</code> property</h3>
<a class="indexterm" name="id4591483"></a><pre class="programlisting">  "label-no-tip"             <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write</pre>
<p>
The text to display in the <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> widget when the query is running
and the widget that the pointer is over has no tooltip.
</p>
<p>Default value: NULL</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4591520"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id4591531"></a><h3>
<a name="GtkTipsQuery-start-query"></a>The <code class="literal">"start-query"</code> signal</h3>
<a class="indexterm" name="id4591547"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tipsquery,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run First</pre>
<p>
Emitted when the query is started.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em>&#160;:</span></p></td>
<td>the object which received the signal.

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4591617"></a><h3>
<a name="GtkTipsQuery-stop-query"></a>The <code class="literal">"stop-query"</code> signal</h3>
<a class="indexterm" name="id4591633"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tipsquery,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run First</pre>
<p>
Emitted when the query is stopped.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em>&#160;:</span></p></td>
<td>the object which received the signal.

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4591703"></a><h3>
<a name="GtkTipsQuery-widget-entered"></a>The <code class="literal">"widget-entered"</code> signal</h3>
<a class="indexterm" name="id4591720"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tipsquery,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>    *widget,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>        *tip_text,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>        *tip_private,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)        : Run Last</pre>
<p>
Emitted when a widget is entered by the pointer while the query is in effect.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em>&#160;:</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></p></td>
<td>the widget that was entered by the pointer.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_text</code></em>&#160;:</span></p></td>
<td>the widget's tooltip.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_private</code></em>&#160;:</span></p></td>
<td>the widget's private tooltip (see <a class="link" href="GtkTooltips.html#gtk-tooltips-set-tip"><code class="function">gtk_tooltips_set_tip()</code></a>).

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4591868"></a><h3>
<a name="GtkTipsQuery-widget-selected"></a>The <code class="literal">"widget-selected"</code> signal</h3>
<a class="indexterm" name="id4591885"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a>   *tipsquery,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>      *widget,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>          *tip_text,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>          *tip_private,
                                                        <a
href="/usr/share/gtk-doc/html/gdk/gdk-Event-Structures.html#GdkEventButton"
>GdkEventButton</a> *event,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)        : Run Last</pre>
<p>
Emitted when a widget is selected during a query.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em>&#160;:</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></p></td>
<td>the widget that was selected.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_text</code></em>&#160;:</span></p></td>
<td>the widget's tooltip.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_private</code></em>&#160;:</span></p></td>
<td>the widget's private tooltip (see <a class="link" href="GtkTooltips.html#gtk-tooltips-set-tip"><code class="function">gtk_tooltips_set_tip()</code></a>).
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em>&#160;:</span></p></td>
<td>the button press or button release event.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>
<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the query should be stopped.

</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4592076"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><a class="link" href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a></span></p></td>
<td><p>the object which handles tooltips.</p></td>
</tr></tbody>
</table></div>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id4592106"></a><div class="refsect2" lang="en"><a name="id4592107"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id4592108"></a></div>
</div>
</div>
</body>
</html>