gtk-signals.html

最新gtk中文资料集

</div>
<p>
Creates a new signal type.  (This is usually done in a
class initializer.)
</p>
<p>
This function take the types as an array, instead of a list
following the arguments.  Otherwise the same as <a class="link" href="gtk-Signals.html#gtk-signal-new"><code class="function">gtk_signal_new()</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>name</code></em>&#160;:</span></p></td>
<td>the name of the signal to create.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>signal_flags</code></em>&#160;:</span></p></td>
<td>see <a class="link" href="gtk-Signals.html#gtk-signal-new"><code class="function">gtk_signal_new()</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>object_type</code></em>&#160;:</span></p></td>
<td>the type of <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> to associate the signal with.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>function_offset</code></em>&#160;:</span></p></td>
<td>how many bytes the function pointer is in
the class structure for this type.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshaller</code></em>&#160;:</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_val</code></em>&#160;:</span></p></td>
<td>the type of the return value, or <span class="type">GTK_TYPE_NONE</span> if
you don't want a return value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_args</code></em>&#160;:</span></p></td>
<td>the number of parameters to the user-defined handlers.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>args</code></em>&#160;:</span></p></td>
<td>an array of <a class="link" href="gtk-Types.html#GtkType"><span class="type">GtkType</span></a>s, describing the prototype to
the callbacks.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the signal id.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3332590"></a><h3>
<a name="gtk-signal-lookup"></a>gtk_signal_lookup()</h3>
<a class="indexterm" name="id3332606"></a><pre class="programlisting">#define             gtk_signal_lookup(name,object_type)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_signal_lookup</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-lookup"
><code class="function">g_signal_lookup()</code></a> instead.</p>
</div>
<p>
Given the name of the signal and the type of object it connects
to, get the signal's identifying integer.  Emitting the signal
by number is somewhat faster than using the name each time.
</p>
<p>
It also tries the ancestors of the given type.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
<td>the signal's name, e.g. clicked.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>object_type</code></em>&#160;:</span></p></td>
<td>the type that the signal operates on, e.g. <span class="type">GTK_TYPE_BUTTON</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the signal's identifying number, or 0 if no signal was found.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3332708"></a><h3>
<a name="gtk-signal-name"></a>gtk_signal_name()</h3>
<a class="indexterm" name="id3332723"></a><pre class="programlisting">#define             gtk_signal_name(signal_id)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_signal_name</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-name"
><code class="function">g_signal_name()</code></a> instead.</p>
</div>
<p>
Given the signal's identifier, finds its name.
</p>
<p>
Two different signals may have the same name, if they have differing types.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>signal_id</code></em>&#160;:</span></p></td>
<td>the signal's identifying number.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the signal name, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if the signal number was invalid.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3332808"></a><h3>
<a name="gtk-signal-emit"></a>gtk_signal_emit ()</h3>
<a class="indexterm" name="id3332824"></a><pre class="programlisting">void                gtk_signal_emit                     (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> signal_id,
                                                         ...);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_signal_emit</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-emit"
><code class="function">g_signal_emit()</code></a> instead.</p>
</div>
<p>
Emits a signal.  This causes the default handler and user-defined
handlers to be run.
</p>
<p>
Here is what <a class="link" href="gtk-Signals.html#gtk-signal-emit"><code class="function">gtk_signal_emit()</code></a> does:
</p>
<p>
1.  Calls the default handler and the user-connected handlers.
The default handler will be called first if
<span class="type">GTK_RUN_FIRST</span> is set, and last if <span class="type">GTK_RUN_LAST</span> is set.
</p>
<p>
2.  Calls all handlers connected with the "after" flag set.
</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>signal_id</code></em>&#160;:</span></p></td>
<td>the signal identifier.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td>the parameters to the function, followed
by a pointer to the return type, if any.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3332975"></a><h3>
<a name="gtk-signal-emit-by-name"></a>gtk_signal_emit_by_name ()</h3>
<a class="indexterm" name="id3332991"></a><pre class="programlisting">void                gtk_signal_emit_by_name             (<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,
                                                         ...);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_signal_emit_by_name</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-emit-by-name"
><code class="function">g_signal_emit_by_name()</code></a> instead.</p>
</div>
<p>
Emits a signal.  This causes the default handler and user-connected
handlers to be run.
</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>the name of the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td>the parameters to the function, followed
by a pointer to the return type, if any.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3333102"></a><h3>
<a name="gtk-signal-emitv"></a>gtk_signal_emitv ()</h3>
<a class="indexterm" name="id3333118"></a><pre class="programlisting">void                gtk_signal_emitv                    (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> signal_id,
                                                         <a class="link" href="gtk-Types.html#GtkArg">GtkArg</a> *args);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_signal_emitv</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-emitv"
><code class="function">g_signal_emitv()</code></a> instead.</p>
</div>
<p>
Emits a signal.  This causes the default handler and user-connected
handlers to be run.  This differs from <a class="link" href="gtk-Signals.html#gtk-signal-emit"><code class="function">gtk_signal_emit()</code></a> by taking
an array of GtkArgs instead of using C's varargs mechanism.
</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 to emit the signal to.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>signal_id</code></em>&#160;:</span></p></td>
<td>the signal identifier.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>args</code></em>&#160;:</span></p></td>
<td>an array of GtkArgs, one for each parameter,
followed by one which is a pointer to the return type.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3333248"></a><h3>
<a name="gtk-signal-emitv-by-name"></a>gtk_signal_emitv_by_name ()</h3>
<a class="indexterm" name="id3333265"></a><pre class="programlisting">void                gtk_signal_emitv_by_name            (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         const <a