gtk-general.html

最新gtk中文资料集

<a name="id3143279"></a><h3>
<a name="gtk-init"></a>gtk_init ()</h3>
<a class="indexterm" name="id3143291"></a><pre class="programlisting">void                gtk_init                            (int *argc,
                                                         char ***argv);</pre>
<p>
Call this function before using any other GTK+ functions in your GUI
applications.  It will initialize everything needed to operate the 
toolkit and parses some standard command line options. <em class="parameter"><code>argc</code></em> and 
<em class="parameter"><code>argv</code></em> are adjusted accordingly so your own code will 
never see those standard arguments. 
</p>
<p>
Note that there are some alternative ways to initialize GTK+: 
if you are calling <a class="link" href="gtk-General.html#gtk-parse-args"><code class="function">gtk_parse_args()</code></a>, <a class="link" href="gtk-General.html#gtk-init-check"><code class="function">gtk_init_check()</code></a>, 
<a class="link" href="gtk-General.html#gtk-init-with-args"><code class="function">gtk_init_with_args()</code></a> or <a
href="/usr/share/gtk-doc/html/glib/glib-Commandline-option-parser.html#g-option-context-parse"
><code class="function">g_option_context_parse()</code></a> with 
the option group returned by <a class="link" href="gtk-General.html#gtk-get-option-group"><code class="function">gtk_get_option_group()</code></a>, you 
<span class="emphasis"><em>don't</em></span> have to call <a class="link" href="gtk-General.html#gtk-init"><code class="function">gtk_init()</code></a>.
</p>
<p>
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
This function will terminate your program if it was unable to initialize 
the GUI for some reason. If you want your program to fall back to a 
textual interface you want to call <a class="link" href="gtk-General.html#gtk-init-check"><code class="function">gtk_init_check()</code></a> instead.
</p>
</div>
<p>
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
</p>
</div>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>argc</code></em>&#160;:</span></p></td>
<td> Address of the <em class="parameter"><code>argc</code></em> parameter of your 
  <code class="function">main()</code> function. Changed if any arguments were handled.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>argv</code></em>&#160;:</span></p></td>
<td> Address of the <em class="parameter"><code>argv</code></em> parameter of <code class="function">main()</code>. 
  Any parameters understood by <a class="link" href="gtk-General.html#gtk-init"><code class="function">gtk_init()</code></a> are stripped before return.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3143524"></a><h3>
<a name="gtk-init-check"></a>gtk_init_check ()</h3>
<a class="indexterm" name="id3143536"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_init_check                      (int *argc,
                                                         char ***argv);</pre>
<p>
This function does the same work as <a class="link" href="gtk-General.html#gtk-init"><code class="function">gtk_init()</code></a> with only 
a single change: It does not terminate the program if the GUI can't be 
initialized. Instead it returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> on failure.
</p>
<p>
This way the application can fall back to some other means of communication 
with the user - for example a curses or command line interface.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>argc</code></em>&#160;:</span></p></td>
<td> Address of the <em class="parameter"><code>argc</code></em> parameter of your 
  <code class="function">main()</code> function. Changed if any arguments were handled.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>argv</code></em>&#160;:</span></p></td>
<td> Address of the <em class="parameter"><code>argv</code></em> parameter of <code class="function">main()</code>. 
  Any parameters understood by <a class="link" href="gtk-General.html#gtk-init"><code class="function">gtk_init()</code></a> are stripped before return.
</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 GUI has been successfully initialized, 
              <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3143711"></a><h3>
<a name="gtk-init-with-args"></a>gtk_init_with_args ()</h3>
<a class="indexterm" name="id3143727"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_init_with_args                  (int *argc,
                                                         char ***argv,
                                                         char *parameter_string,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Commandline-option-parser.html#GOptionEntry"
>GOptionEntry</a> *entries,
                                                         char *translation_domain,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
This function does the same work as <a class="link" href="gtk-General.html#gtk-init-check"><code class="function">gtk_init_check()</code></a>. 
Additionally, it allows you to add your own commandline options, 
and it automatically generates nicely formatted 
<code class="option">--help</code> output. Note that your program will
be terminated after writing out the help output.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>argc</code></em>&#160;:</span></p></td>
<td> a pointer to the number of command line arguments.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>argv</code></em>&#160;:</span></p></td>
<td> a pointer to the array of command line arguments.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>parameter_string</code></em>&#160;:</span></p></td>
<td> a string which is displayed in
   the first line of <code class="option">--help</code> output, after 
   <code class="literal"><em class="replaceable"><code>programname</code></em> [OPTION...]</code>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>entries</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>-terminated array of <a
href="/usr/share/gtk-doc/html/glib/glib-Commandline-option-parser.html#GOptionEntry"
><span class="type">GOptionEntry</span></a>s
   describing the options of your program
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>translation_domain</code></em>&#160;:</span></p></td>
<td> a translation domain to use for translating
   the <code class="option">--help</code> output for the options in <em class="parameter"><code>entries</code></em>
   with <code class="function">gettext()</code>, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> a return location for errors 
</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 GUI has been successfully initialized, 
              <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144008"></a><h3>
<a name="gtk-get-option-group"></a>gtk_get_option_group ()</h3>
<a class="indexterm" name="id3144023"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Commandline-option-parser.html#GOptionGroup"
>GOptionGroup</a>*       gtk_get_option_group                (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> open_default_display);</pre>
<p>
Returns a <a
href="/usr/share/gtk-doc/html/glib/glib-Commandline-option-parser.html#GOptionGroup"
><span class="type">GOptionGroup</span></a> for the commandline arguments recognized
by GTK+ and GDK. You should add this group to your <a
href="/usr/share/gtk-doc/html/glib/glib-Commandline-option-parser.html#GOptionContext"
><span class="type">GOptionContext</span></a> 
with <a
href="/usr/share/gtk-doc/html/glib/glib-Commandline-option-parser.html#g-option-context-add-group"
><code class="function">g_option_context_add_group()</code></a>, if you are using 
<a
href="/usr/share/gtk-doc/html/glib/glib-Commandline-option-parser.html#g-option-context-parse"
><code class="function">g_option_context_parse()</code></a> to parse your commandline arguments.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>open_default_display</code></em>&#160;:</span></p></td>
<td> whether to open the default display 
   when parsing the commandline arguments
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Commandline-option-parser.html#GOptionGroup"
><span class="type">GOptionGroup</span></a> for the commandline arguments recognized
  by GTK+

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144144"></a><h3>
<a name="gtk-exit"></a>gtk_exit ()</h3>
<a class="indexterm" name="id3144159"></a><pre class="programlisting">void                gtk_exit                            (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> error_code);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_exit</code> is deprecated and should not be used in newly-written code. Use the standard <code class="function">exit()</code> function instead.</p>
</div>
<p>
Terminates the program and returns the given exit code to the caller. 
This function will shut down the GUI and free all resources allocated 
for GTK+.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>error_code</code></em>&#160;:</span></p></td>
<td>Return value to pass to the caller. This is dependent on the
target system but at least on Unix systems <code class="literal">0</code> means success.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144245"></a><h3>
<a name="gtk-events-pending"></a>gtk_events_pending ()</h3>
<a class="indexterm" name="id3144258"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_events_pending                  (void);</pre>
<p>
Checks if any events are pending. This can be used to update the GUI 
and invoke timeouts etc. while doing some time intensive computation.
</p>
<div class="example">