gtk-general.html

最新gtk中文资料集

>gboolean</a>            gtk_true                            (void);</pre>
<p>
All this function does it to return <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>. This can be useful for example
if you want to inhibit the deletion of a window. Of course you should 
not do this as the user expects a reaction from clicking the close 
icon of the window...
</p>
<div class="example">
<a name="id3145112"></a><p class="title"><b>Example&#160;3.&#160;A persistent window</b></p>
<div class="example-contents"><pre class="programlisting">
##include &lt;gtk/gtk.h&gt;

int
main (int argc, char **argv)
{
  GtkWidget     *win, *but;

  gtk_init( &amp;argc, &amp;argv );

  win = gtk_window_new (GTK_WINDOW_TOPLEVEL);
  g_signal_connect (win, "delete-event",
                    G_CALLBACK (gtk_true), NULL);
  g_signal_connect (win, "destroy",
		    G_CALLBACK (gtk_main_quit), NULL);

  but = gtk_button_new_with_label ("Close yourself. I mean it!");
  g_signal_connect_swapped (but, "clicked",
		  G_CALLBACK (gtk_object_destroy), win);
  gtk_container_add (GTK_CONTAINER (win), but);

  gtk_widget_show_all (win);
  gtk_main ();
  return 0;
}
</pre></div>
</div>
<br class="example-break"><div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><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>


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145173"></a><h3>
<a name="gtk-false"></a>gtk_false ()</h3>
<a class="indexterm" name="id3145185"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_false                           (void);</pre>
<p>
Analogical to <a class="link" href="gtk-General.html#gtk-true"><code class="function">gtk_true()</code></a> this function does nothing 
but always returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><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#FALSE:CAPS"
><code class="literal">FALSE</code></a>


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145251"></a><h3>
<a name="gtk-grab-add"></a>gtk_grab_add ()</h3>
<a class="indexterm" name="id3145264"></a><pre class="programlisting">void                gtk_grab_add                        (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<p>
Makes <em class="parameter"><code>widget</code></em> the current grabbed widget. This means that interaction with 
other widgets in the same application is blocked and mouse as well as 
keyboard events are delivered to this widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></p></td>
<td>The widget that grabs keyboard and pointer events.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145320"></a><h3>
<a name="gtk-grab-get-current"></a>gtk_grab_get_current ()</h3>
<a class="indexterm" name="id3145333"></a><pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_grab_get_current                (void);</pre>
<p>
Queries the current grab of the default window group. 
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>The widget which currently has the grab or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if no grab is active.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145381"></a><h3>
<a name="gtk-grab-remove"></a>gtk_grab_remove ()</h3>
<a class="indexterm" name="id3145394"></a><pre class="programlisting">void                gtk_grab_remove                     (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<p>
Removes the grab from the given widget. You have to pair calls to <a class="link" href="gtk-General.html#gtk-grab-add"><code class="function">gtk_grab_add()</code></a>
and <a class="link" href="gtk-General.html#gtk-grab-remove"><code class="function">gtk_grab_remove()</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>widget</code></em>&#160;:</span></p></td>
<td>The widget which gives up the grab.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145463"></a><h3>
<a name="gtk-init-add"></a>gtk_init_add ()</h3>
<a class="indexterm" name="id3145475"></a><pre class="programlisting">void                gtk_init_add                        (<a class="link" href="gtk-Types.html#GtkFunction">GtkFunction</a> function,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
Registers a function to be called when the mainloop 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>function</code></em>&#160;:</span></p></td>
<td>Function to invoke when <a class="link" href="gtk-General.html#gtk-main"><code class="function">gtk_main()</code></a> is called next.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>Data to pass to that function.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145556"></a><h3>
<a name="gtk-quit-add-destroy"></a>gtk_quit_add_destroy ()</h3>
<a class="indexterm" name="id3145568"></a><pre class="programlisting">void                gtk_quit_add_destroy                (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> main_level,
                                                         <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object);</pre>
<p>
Trigger destruction of <em class="parameter"><code>object</code></em> in case the mainloop at level <em class="parameter"><code>main_level</code></em>
is quit.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>main_level</code></em>&#160;:</span></p></td>
<td>Level of the mainloop which shall trigger the destruction.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>Object to be destroyed.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145651"></a><h3>
<a name="gtk-quit-add"></a>gtk_quit_add ()</h3>
<a class="indexterm" name="id3145663"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               gtk_quit_add                        (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> main_level,
                                                         <a class="link" href="gtk-Types.html#GtkFunction">GtkFunction</a> function,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
Registers a function to be called when an instance of the mainloop is left.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>main_level</code></em>&#160;:</span></p></td>
<td>Level at which termination the function shall be called. You
 can pass 0 here to have the function run at the termination of the current
 mainloop.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>function</code></em>&#160;:</span></p></td>
<td>The function to call. This should return 0 to be removed from the 
 list of quit handlers. Otherwise the function might be called again.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>Pointer to pass when calling <em class="parameter"><code>function</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>A handle for this quit handler (you need this for <a class="link" href="gtk-General.html#gtk-quit-remove"><code class="function">gtk_quit_remove()</code></a>)
  or 0 if you passed a <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> pointer in <em class="parameter"><code>function</code></em>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145804"></a><h3>
<a name="gtk-quit-add-full"></a>gtk_quit_add_full ()</h3>
<a class="indexterm" name="id3145817"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               gtk_quit_add_full                   (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> main_level,
                                                         <a class="link" href="gtk-Types.html#GtkFunction">GtkFunction</a> function,
                                                         <a class="link" href="gtk-Types.html#GtkCallbackMarshal">GtkCallbackMarshal</a> marshal,
                                                         <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);</pre>
<p>
Registers a function to be called when an instance of the mainloop is left.
In comparison to <a class="link" href="gtk-General.html#gtk-quit-add"><code class="function">gtk_quit_add()</code></a> this function adds the possibility to 
pass a marshaller and a function to be called when the quit handler is freed.
</p>
<p>
The former can be