gtkaboutdialog.html

最新gtk中文资料集

>gchararray</a>            : Read / Write
  "<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--documenters">documenters</a>"              <a
href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html#GStrv"
>GStrv</a>                 : Read / Write
  "<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--license">license</a>"                  <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write
  "<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--logo">logo</a>"                     <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>             : Read / Write
  "<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--logo-icon-name">logo-icon-name</a>"           <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write
  "<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--program-name">program-name</a>"             <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write
  "<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--translator-credits">translator-credits</a>"       <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write
  "<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--version">version</a>"                  <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write
  "<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--website">website</a>"                  <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write
  "<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--website-label">website-label</a>"            <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write
  "<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--wrap-license">wrap-license</a>"             <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3414784"></a><h2>Description</h2>
<p>
The <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> offers a simple way to display information about
a program like its logo, name, copyright, website and license. It is
also possible to give credits to the authors, documenters, translators
and artists who have worked on the program. An about dialog is typically
opened when the user selects the <code class="literal">About</code> option from 
the <code class="literal">Help</code> menu. All parts of the dialog are optional.
</p>
<p>
About dialog often contain links and email addresses. <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> 
supports this by offering global hooks, which are called when the user
clicks on a link or email address, see <a class="link" href="GtkAboutDialog.html#gtk-about-dialog-set-email-hook"><code class="function">gtk_about_dialog_set_email_hook()</code></a>
and <a class="link" href="GtkAboutDialog.html#gtk-about-dialog-set-url-hook"><code class="function">gtk_about_dialog_set_url_hook()</code></a>. Email addresses in the 
authors, documenters and artists properties are recognized by looking for
<code class="literal">&lt;user@host&gt;</code>, URLs are 
recognized by looking for <code class="literal">http://url</code>, with 
<code class="literal">url</code> extending to the next space, tab or line break.
</p>
<p>
To make constructing a <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> as convenient as possible, you can
use the function <a class="link" href="GtkAboutDialog.html#gtk-show-about-dialog"><code class="function">gtk_show_about_dialog()</code></a> which constructs and shows a dialog 
and keeps it around so that it can be shown again.
</p>
<p>
Note that GTK+ sets a default title of <code class="literal">_("About %s")</code> 
on the dialog window (where %s is replaced by the name of the 
application, but in order to ensure proper translation of the title, 
applications should set the title property explicitly when constructing 
a <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>, as shown in the following example:
</p>
<div class="informalexample"><pre class="programlisting">
gtk_show_about_dialog (NULL, 
                       "program-name", "ExampleCode",
                       "logo", example_logo,
                       "title" _("About ExampleCode"),
                       NULL);
</pre></div>
<p>
Note that prior to GTK+ 2.12, the <a class="link" href="GtkAboutDialog.html#GtkAboutDialog--program-name"><span class="type">"program-name"</span></a> property
was called "name". This was changed to avoid the conflict with the
<a class="link" href="GtkWidget.html#GtkWidget--name"><span class="type">"name"</span></a> property.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3414968"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3414978"></a><h3>
<a name="GtkAboutDialog-struct"></a>GtkAboutDialog</h3>
<a class="indexterm" name="id3414992"></a><pre class="programlisting">typedef struct _GtkAboutDialog GtkAboutDialog;</pre>
<p>
The <span class="structname">GtkAboutDialog</span> struct contains
only private fields and should not be directly accessed.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3415013"></a><h3>
<a name="gtk-about-dialog-new"></a>gtk_about_dialog_new ()</h3>
<a class="indexterm" name="id3415027"></a><pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_about_dialog_new                (void);</pre>
<p>
Creates a new <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>.</p>
<p>

</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 newly created <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>

</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3415090"></a><h3>
<a name="gtk-about-dialog-get-name"></a>gtk_about_dialog_get_name ()</h3>
<a class="indexterm" name="id3415105"></a><a class="indexterm" name="id3415115"></a><pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        gtk_about_dialog_get_name           (<a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog">GtkAboutDialog</a> *about);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_about_dialog_get_name</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the program name displayed in the about dialog.</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>about</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The program name. The string is owned by the about
 dialog and must not be modified.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.6

@Deprecated: 2.12: Use gtk_about_dialog_get_program_name() instead.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3415205"></a><h3>
<a name="gtk-about-dialog-set-name"></a>gtk_about_dialog_set_name ()</h3>
<a class="indexterm" name="id3415221"></a><a class="indexterm" name="id3415231"></a><pre class="programlisting">void                gtk_about_dialog_set_name           (<a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog">GtkAboutDialog</a> *about,
                                                         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_about_dialog_set_name</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the name to display in the about dialog. 
If this is not set, it defaults to <a
href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-get-application-name"
><code class="function">g_get_application_name()</code></a>.</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>about</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
<td> the program name
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.6

@Deprecated: 2.12: Use gtk_about_dialog_set_program_name() instead.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3415342"></a><h3>
<a name="gtk-about-dialog-get-program-name"></a>gtk_about_dialog_get_program_name ()</h3>
<a class="indexterm" name="id3415359"></a><pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        gtk_about_dialog_get_program_name   (<a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog">GtkAboutDialog</a> *about);</pre>
<p>
Returns the program name displayed in the about dialog.</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>about</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The program name. The string is owned by the about
 dialog and must not be modified.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3415437"></a><h3>
<a name="gtk-about-dialog-set-program-name"></a>gtk_about_dialog_set_program_name ()</h3>
<a class="indexterm" name="id3415453"></a><pre class="programlisting">void                gtk_about_dialog_set_program_name   (<a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog">GtkAboutDialog</a> *about,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<p>
Sets the name to display in the about dialog. 
If this is not set, it defaults to <a
href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-get-application-name"
><code class="function">g_get_application_name()</code></a>.</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>about</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
<td> the program name
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3415552"></a><h3>
<a name="gtk-about-dialog-get-version"></a>gtk_about_dialog_get_version ()</h3>
<a class="indexterm" name="id3415568"></a><pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        gtk_about_dialog_get_version        (<a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog">GtkAboutDialog</a> *about);</pre>
<p>
Returns the version string.</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>about</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The version string. The string is owned by the about
 dialog and must not be modified.