gtk-signals.html

最新gtk中文资料集

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></p></td>
<td>the function to callback.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>slot_object</code></em>&#160;:</span></p></td>
<td>the object to pass as the first parameter to func.
(Though it pretends to take an object, you can
really pass any gpointer as the <span class="type">slot_object</span> .)
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the connection id.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3334155"></a><h3>
<a name="gtk-signal-connect-object-after"></a>gtk_signal_connect_object_after()</h3>
<a class="indexterm" name="id3334171"></a><pre class="programlisting">#define             gtk_signal_connect_object_after(object,name,func,slot_object)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_signal_connect_object_after</code> is deprecated and should not be used in newly-written code. Use <a
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-data"
><code class="function">g_signal_connect_data()</code></a> instead, passing 
<code class="literal">G_CONNECT_AFTER|G_CONNECT_SWAPPED</code> as <em class="parameter"><code>connect_flags</code></em>.</p>
</div>
<p>
Attaches a signal hook to a signal, passing in an alternate
object as the first parameter, and guaranteeing 
that the default handler and all normal
handlers are called first.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>the object associated with the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
<td>name of the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></p></td>
<td>function pointer to attach to the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>slot_object</code></em>&#160;:</span></p></td>
<td>the object to pass as the first parameter to <span class="type">func</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the connection id.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3334308"></a><h3>
<a name="gtk-signal-connect-full"></a>gtk_signal_connect_full ()</h3>
<a class="indexterm" name="id3334325"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gulong"
>gulong</a>              gtk_signal_connect_full             (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
                                                         <a class="link" href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> func,
                                                         <a class="link" href="gtk-Types.html#GtkCallbackMarshal">GtkCallbackMarshal</a> unsupported,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
                                                         <a class="link" href="gtk-Types.html#GtkDestroyNotify">GtkDestroyNotify</a> destroy_func,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> object_signal,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> after);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_signal_connect_full</code> is deprecated and should not be used in newly-written code. Use <a
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-data"
><code class="function">g_signal_connect_data()</code></a> instead.</p>
</div>
<p>
Attaches a function pointer and user data to a signal with
more control.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>the object which emits the signal.  For example, a button
in the button press signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
<td>the name of the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></p></td>
<td>function pointer to attach to the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>unsupported</code></em>&#160;:</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>the user data associated with the function.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>destroy_func</code></em>&#160;:</span></p></td>
<td>function to call when this particular hook is 
disconnected.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>object_signal</code></em>&#160;:</span></p></td>
<td>whether this is an object signal-- basically an "object
signal" is one that wants its user_data and object fields switched,
which is useful for calling functions which operate on another
object primarily.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>after</code></em>&#160;:</span></p></td>
<td>whether to invoke the user-defined handler after the signal, or to let 
the signal's default behavior preside (i.e. depending on <span class="type">GTK_RUN_FIRST</span>
and <span class="type">GTK_RUN_LAST</span>).
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the connection id.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3334585"></a><h3>
<a name="gtk-signal-connect-while-alive"></a>gtk_signal_connect_while_alive ()</h3>
<a class="indexterm" name="id3334602"></a><pre class="programlisting">void                gtk_signal_connect_while_alive      (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
                                                         <a class="link" href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> func,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> func_data,
                                                         <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *alive_object);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_signal_connect_while_alive</code> is deprecated and should not be used in newly-written code. Use <a
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-object"
><code class="function">g_signal_connect_object()</code></a> instead.</p>
</div>
<p>
Attaches a function pointer and another <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> to a signal.
</p>
<p>
This function takes an object whose "destroy" signal
should be trapped.
That way, you don't have to clean up the
signal handler when you destroy the object.
It is a little less efficient though.
</p>
<p>
(Instead you may call <a class="link" href="gtk-Signals.html#gtk-signal-disconnect-by-data"><code class="function">gtk_signal_disconnect_by_data()</code></a>, if you want
to explicitly delete all attachments to this object.  This
is perhaps not recommended since it could be confused
with an integer masquerading as a pointer (through <a
href="/usr/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html#GINT-TO-POINTER:CAPS"
><code class="function">GINT_TO_POINTER()</code></a>).)
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>the object that emits the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
<td>name of the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></p></td>
<td>function pointer to attach to the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func_data</code></em>&#160;:</span></p></td>
<td>pointer to pass to func.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>alive_object</code></em>&#160;:</span></p></td>
<td>object whose death should cause the handler connection
to be destroyed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3334809"></a><h3>
<a name="gtk-signal-connect-object-while-alive"></a>gtk_signal_connect_object_while_alive ()</h3>
<a class="indexterm" name="id3334825"></a><pre class="programlisting">void                gtk_signal_connect_object_while_alive
                                                        (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
                                                         <a class="link" href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> func,
                                                         <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *alive_object);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_signal_connect_object_while_alive</code> is deprecated and should not be used in newly-written code. Use <a
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-object"
><code class="function">g_signal_connect_object()</code></a> instead, passing 
<code class="literal">G_CONNECT_SWAPPED</code> as <em class="parameter"><code>connect_flags</code></em>.</p>
</div>
<p>
These signal connectors are for signals which refer to objects,
so they must not be called after the object is deleted.
</p>
<p>
Unlike <a class="link" href="gtk-Signals.html#gtk-signal-connect-while-alive"><code class="function">gtk_signal_connect_while_alive()</code></a>,
this swaps the object and user data, making it suitable for
use with functions which primarily operate on the user data.
</p>
<p>
This function acts just like <a class="link" href="gtk-Signals.html#gtk-signal-connect-object"><code class="function">gtk_signal_connect_object()</code></a> except
it traps the "destroy" signal to prevent you from having to
clean up the handler.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>the object associated with the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
<td>name of the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em clas