/usr/share/gtk-doc/html/pygtk/class-gtkaboutdialog.html is in python-gtk2-doc 2.24.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.AboutDialog</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="next" href="class-gtkaccelgroup.html" title="gtk.AccelGroup"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.AboutDialog</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="gtk-class-reference.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkaccelgroup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.AboutDialog"><a name="class-gtkaboutdialog"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.AboutDialog</h2><p>gtk.AboutDialog — popup window displaying information about an
application (new in PyGTK 2.6)</p></div><div class="refsect1" title="Synopsis"><a name="id3555245"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.AboutDialog</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkdialog.html" title="gtk.Dialog">gtk.Dialog</a></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#constructor-gtkaboutdialog" title="Constructor">gtk.AboutDialog</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-name" title="gtk.AboutDialog.get_name">get_name</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-name" title="gtk.AboutDialog.set_name">set_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-program-name" title="gtk.AboutDialog.get_program_name">get_program_name</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-program-name" title="gtk.AboutDialog.set_program_name">set_program_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-version" title="gtk.AboutDialog.get_version">get_version</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-version" title="gtk.AboutDialog.set_version">set_version</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>version</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-copyright" title="gtk.AboutDialog.get_copyright">get_copyright</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-copyright" title="gtk.AboutDialog.set_copyright">set_copyright</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>copyright</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-comments" title="gtk.AboutDialog.get_comments">get_comments</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-comments" title="gtk.AboutDialog.set_comments">set_comments</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>comments</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-license" title="gtk.AboutDialog.get_license">get_license</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-license" title="gtk.AboutDialog.set_license">set_license</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>license</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-wrap-license" title="gtk.AboutDialog.get_wrap_license">get_wrap_license</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-wrap-license" title="gtk.AboutDialog.set_wrap_license">set_wrap_license</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>wrap_license</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-website" title="gtk.AboutDialog.get_website">get_website</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-website" title="gtk.AboutDialog.set_website">set_website</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>website</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-website-label" title="gtk.AboutDialog.get_website_label">get_website_label</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-website-label" title="gtk.AboutDialog.set_website_label">set_website_label</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>website_label</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-authors" title="gtk.AboutDialog.get_authors">get_authors</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-authors" title="gtk.AboutDialog.set_authors">set_authors</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>authors</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-documenters" title="gtk.AboutDialog.get_documenters">get_documenters</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-documenters" title="gtk.AboutDialog.set_documenters">set_documenters</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>documenters</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-artists" title="gtk.AboutDialog.get_artists">get_artists</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-artists" title="gtk.AboutDialog.set_artists">set_artists</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>artists</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-translator-credits" title="gtk.AboutDialog.get_translator_credits">get_translator_credits</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-translator-credits" title="gtk.AboutDialog.set_translator_credits">set_translator_credits</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>translator_credits</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-logo" title="gtk.AboutDialog.get_logo">get_logo</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-logo" title="gtk.AboutDialog.set_logo">set_logo</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>logo</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--get-logo-icon-name" title="gtk.AboutDialog.get_logo_icon_name">get_logo_icon_name</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-logo-icon-name" title="gtk.AboutDialog.set_logo_icon_name">set_logo_icon_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon_name</code></strong></span></span>)</code><br></pre></td></tr></table><pre class="programlisting">
<span class="bold"><strong>Functions</strong></span>
<code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#function-gtk--about-dialog-set-email-hook" title="gtk.about_dialog_set_email_hook">gtk.about_dialog_set_email_hook</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkaboutdialog.html#function-gtk--about-dialog-set-url-hook" title="gtk.about_dialog_set_url_hook">gtk.about_dialog_set_url_hook</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span></span>)</code></pre></div><div class="refsect1" title="Ancestry"><a name="id3554558"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
+-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
+-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
+-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
+-- <a class="link" href="class-gtkbin.html" title="gtk.Bin">gtk.Bin</a>
+-- <a class="link" href="class-gtkwindow.html" title="gtk.Window">gtk.Window</a>
+-- <a class="link" href="class-gtkdialog.html" title="gtk.Dialog">gtk.Dialog</a>
+--<a class="link" href="class-gtkaboutdialog.html" title="gtk.AboutDialog">gtk.AboutDialog</a>
</pre><div class="refsect1" title="Implemented Interfaces"><a name="id3554493"></a><h2>Implemented Interfaces</h2><p>
<a class="link" href="class-gtkaboutdialog.html" title="gtk.AboutDialog"><code class="classname">gtk.AboutDialog</code></a>
implements
<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
<a class="link" href="class-atkimplementor.html" title="atk.Implementor"><code class="classname">atk.ImplementorIFace</code></a>
</p></div></div><div class="refsect1" title="gtk.AboutDialog Properties"><a name="properties-gtkaboutdialog"></a><h2>gtk.AboutDialog Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p><p><a class="link" href="class-gtkwindow.html#properties-gtkwindow" title="gtk.Window Properties">gtk.Window Properties</a></p><p><a class="link" href="class-gtkdialog.html#properties-gtkdialog" title="gtk.Dialog Properties">gtk.Dialog Properties</a></p><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"artists"</td><td valign="top">Read-Write</td><td valign="top">The list of people who have contributed artwork to
the program.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"authors"</td><td valign="top">Read-Write</td><td valign="top">The list of authors of the program.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"comments"</td><td valign="top">Read-Write</td><td valign="top">A string containing comments about the program.
Default value: <code class="literal">None</code>.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"copyright"</td><td valign="top">Read-Write</td><td valign="top">A string containing copyright information for
the program. Default value: <code class="literal">None</code>.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"documenters"</td><td valign="top">Read-Write</td><td valign="top">The list of people documenting the program.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"license"</td><td valign="top">Read-Write</td><td valign="top">A string containing the license of the program.
Default value: <code class="literal">None</code>.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"logo"</td><td valign="top">Read-Write</td><td valign="top">A logo for the about box. If this is not set,
it defaults to the default window icon list.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"logo-icon-name"</td><td valign="top">Read-Write</td><td valign="top">The name of an icon to use as the logo for the
about box. Default value: <code class="literal">None</code>.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"program-name"</td><td valign="top">Read-Write</td><td valign="top">The name of the program. If this is not set, it
defaults to g_get_application_name().
Default value: <code class="literal">None</code>.
This property is available in GTK+ 2.12 and above.</td></tr><tr valign="top"><td valign="top">"translator-credits"</td><td valign="top">Read-Write</td><td valign="top">Credits to the translators. This string should be
marked as translatable. Default value: <code class="literal">None</code>.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"version"</td><td valign="top">Read-Write</td><td valign="top">A string containing the version of the program.
Default value: <code class="literal">None</code>.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"website"</td><td valign="top">Read-Write</td><td valign="top">The URL for the link to the website of the
program. Default value: <code class="literal">None</code>.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"website-label"</td><td valign="top">Read-Write</td><td valign="top">The label for the link to the website of the program.
If this is not set, it defaults to the URL.
Default value: <code class="literal">None</code>.
This property is available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"wrap-license"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> the license text should be
wrapped. Default value: <code class="literal">False</code>.
This property is available in GTK+ 2.6 and above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.AboutDialog Style Properties"><a name="style-properties-gtkaboutdialog"></a><h2>gtk.AboutDialog Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p><p><a class="link" href="class-gtkdialog.html#style-properties-gtkdialog" title="gtk.Dialog Style Properties">gtk.Dialog Style Properties</a></p><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"link-color"</td><td valign="top">Read</td><td valign="top">The color of hyperlinks. This property is not available
in GTK+ 2.10 and above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.AboutDialog Signal Prototypes"><a name="signal-prototypes-gtkaboutdialog"></a><h2>gtk.AboutDialog Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p><p><a class="link" href="class-gtkwindow.html#signal-prototypes-gtkwindow" title="gtk.Window Signal Prototypes">gtk.Window Signal Prototypes</a></p><p><a class="link" href="class-gtkdialog.html#signal-prototypes-gtkdialog" title="gtk.Dialog Signal Prototypes">gtk.Dialog Signal Prototypes</a></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtkaboutdialog.html#signal-gtkaboutdialog--activate-link" title='The "activate-link" gtk.AboutDialog Signal'>activate-link</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>aboutdialog</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>uri</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Description"><a name="id3553911"></a><h2>Description</h2><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This widget is available in PyGTK 2.6 and above.</p></div><p>The <a class="link" href="class-gtkaboutdialog.html" title="gtk.AboutDialog"><code class="classname">gtk.AboutDialog</code></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 <span class="guimenuitem">About</span> option from the <span class="guimenu">Help</span>
menu. All parts of the dialog are optional.</p><p>About dialog often contain links and email addresses. <a class="link" href="class-gtkaboutdialog.html" title="gtk.AboutDialog"><code class="classname">gtk.AboutDialog</code></a>
supports this by offering global hooks, which are called when the user
clicks on a link or email address, see the <a class="link" href="class-gtkaboutdialog.html#function-gtk--about-dialog-set-email-hook" title="gtk.about_dialog_set_email_hook"><code class="function">gtk.about_dialog_set_email_hook</code>()</a>
and <a class="link" href="class-gtkaboutdialog.html#function-gtk--about-dialog-set-url-hook" title="gtk.about_dialog_set_url_hook"><code class="function">gtk.about_dialog_set_url_hook</code>()</a>
functions. Email addresses in the authors, documenters and artists
properties are recognized by looking for <code class="literal"><user@host></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></div><div class="refsect1" title="Constructor"><a name="constructor-gtkaboutdialog"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.AboutDialog</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-gtkdialog.html" title="gtk.Dialog"><code class="classname">gtk.AboutDialog</code></a></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This constructor is available in PyGTK 2.6 and above.</p></div><p>Creates a new gtk.AboutDialog with default property values.</p></div><div class="refsect1" title="Methods"><a name="id3553756"></a><h2>Methods</h2><div class="refsect2" title="gtk.AboutDialog.get_name"><a name="method-gtkaboutdialog--get-name"></a><h3>gtk.AboutDialog.get_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_name</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the program name.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
This method is deprecated in PyGTK 2.12 and above and should not be
used in newly-written code. Use the <a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-program-name" title="gtk.AboutDialog.set_program_name"><code class="methodname">get_program_name</code></a>()
method instead.
</p></div><p>The <code class="methodname">get_name</code>() method returns the
program name displayed in the about dialog.</p></div><div class="refsect2" title="gtk.AboutDialog.set_name"><a name="method-gtkaboutdialog--set-name"></a><h3>gtk.AboutDialog.set_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>a string containing the program
name or <code class="literal">None</code> to use the default name.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
This method is deprecated in PyGTK 2.12 and above and should not be
used in newly-written code. Use the <a class="link" href="class-gtkaboutdialog.html#method-gtkaboutdialog--set-program-name" title="gtk.AboutDialog.set_program_name"><code class="methodname">set_program_name</code></a>()
method instead.
</p></div><p>The <code class="methodname">set_name</code>() method sets the name
to display in the about dialog. If <em class="parameter"><code>name</code></em> is <code class="literal">None</code>,
it defaults to g_get_application_name().</p></div><div class="refsect2" title="gtk.AboutDialog.get_program_name"><a name="method-gtkaboutdialog--get-program-name"></a><h3>gtk.AboutDialog.get_program_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_program_name</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the program name.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>The <code class="methodname">get_program_name</code>() method returns the
program name displayed in the about dialog.</p></div><div class="refsect2" title="gtk.AboutDialog.set_program_name"><a name="method-gtkaboutdialog--set-program-name"></a><h3>gtk.AboutDialog.set_program_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_program_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>a string containing the program
name or <code class="literal">None</code> to use the default name.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>The <code class="methodname">set_program_name</code>() method sets the name
to display in the about dialog. If <em class="parameter"><code>name</code></em> is <code class="literal">None</code>,
it defaults to g_get_application_name().</p></div><div class="refsect2" title="gtk.AboutDialog.get_version"><a name="method-gtkaboutdialog--get-version"></a><h3>gtk.AboutDialog.get_version</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_version</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The version string or
<code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_version</code>() method returns the
string contained in the "version" property.</p></div><div class="refsect2" title="gtk.AboutDialog.set_version"><a name="method-gtkaboutdialog--set-version"></a><h3>gtk.AboutDialog.set_version</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_version</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>version</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>version</code></strong> :</span></p></td><td>the version string or
<code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_version</code>() method sets the
"version" property to the string in <em class="parameter"><code>version</code></em>.</p></div><div class="refsect2" title="gtk.AboutDialog.get_copyright"><a name="method-gtkaboutdialog--get-copyright"></a><h3>gtk.AboutDialog.get_copyright</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_copyright</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the copyright string or
<code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_copyright</code>() method returns the
string contained in the "copyright" property.</p></div><div class="refsect2" title="gtk.AboutDialog.set_copyright"><a name="method-gtkaboutdialog--set-copyright"></a><h3>gtk.AboutDialog.set_copyright</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_copyright</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>copyright</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>copyright</code></strong> :</span></p></td><td>a string containing the copyright
notice or <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_copyright</code>() method sets the
"copyright" property to the string contained in
<em class="parameter"><code>copyright</code></em>. If <em class="parameter"><code>copyright</code></em> is
<code class="literal">None</code>, the copyright notice is hidden.</p></div><div class="refsect2" title="gtk.AboutDialog.get_comments"><a name="method-gtkaboutdialog--get-comments"></a><h3>gtk.AboutDialog.get_comments</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_comments</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a string containing the
comments or <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_comments</code>() method returns the
string contained in the "comments" property.</p></div><div class="refsect2" title="gtk.AboutDialog.set_comments"><a name="method-gtkaboutdialog--set-comments"></a><h3>gtk.AboutDialog.set_comments</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_comments</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>comments</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>comments</code></strong> :</span></p></td><td>a string containing the
comments or <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_comments</code>() method sets the
"comments" property to the string contained in
<em class="parameter"><code>comments</code></em>. If <em class="parameter"><code>comments</code></em> is
<code class="literal">None</code> the comments label is hidden.</p></div><div class="refsect2" title="gtk.AboutDialog.get_license"><a name="method-gtkaboutdialog--get-license"></a><h3>gtk.AboutDialog.get_license</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_license</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a string containing the license
information or <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_license</code>() method returns the
string contained in the "license" property.</p></div><div class="refsect2" title="gtk.AboutDialog.set_license"><a name="method-gtkaboutdialog--set-license"></a><h3>gtk.AboutDialog.set_license</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_license</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>license</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>license</code></strong> :</span></p></td><td></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_license</code>() method sets the
"license" property to the string contained in
<em class="parameter"><code>license</code></em>. If <em class="parameter"><code>license</code></em> is
<code class="literal">None</code> the license button is hidden.</p></div><div class="refsect2" title="gtk.AboutDialog.get_wrap_license"><a name="method-gtkaboutdialog--get-wrap-license"></a><h3>gtk.AboutDialog.get_wrap_license</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_wrap_license</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the license text
should be wrapped</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">get_wrap_license</code>() method returns
the value of the "wrap-license" property. If "wrap-license" is
<code class="literal">True</code> the license text should be automatically
wrapped.</p></div><div class="refsect2" title="gtk.AboutDialog.set_wrap_license"><a name="method-gtkaboutdialog--set-wrap-license"></a><h3>gtk.AboutDialog.set_wrap_license</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_wrap_license</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>wrap_license</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>wrap_license</code></strong> :</span></p></td><td></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">set_wrap_license</code>() method sets the
"wrap-license" property to the value of
<em class="parameter"><code>wrap_license</code></em>. If <em class="parameter"><code>wrap_license</code></em>
is <code class="literal">True</code> the license text should be automatically
wrapped.</p></div><div class="refsect2" title="gtk.AboutDialog.get_website"><a name="method-gtkaboutdialog--get-website"></a><h3>gtk.AboutDialog.get_website</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_website</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a string containing the website URL or
<code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_website</code>() method returns the
string contained in the "website" property. The website should be a
URL.</p></div><div class="refsect2" title="gtk.AboutDialog.set_website"><a name="method-gtkaboutdialog--set-website"></a><h3>gtk.AboutDialog.set_website</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_website</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>website</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>website</code></strong> :</span></p></td><td>a string containing the URL of the program's
website or <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_website</code>() method sets the
"website" property to the string contained in
<em class="parameter"><code>website</code></em>. The string should be a valid URL.</p></div><div class="refsect2" title="gtk.AboutDialog.get_website_label"><a name="method-gtkaboutdialog--get-website-label"></a><h3>gtk.AboutDialog.get_website_label</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_website_label</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a string containing the website link
label</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_website_label</code>() method returns
the contents of the "website_label" property. The website label is used if
the url hook has been set using the <a class="link" href="class-gtkaboutdialog.html#function-gtk--about-dialog-set-url-hook" title="gtk.about_dialog_set_url_hook"><code class="function">gtk.about_dialog_set_url_hook</code>()</a>
function.</p></div><div class="refsect2" title="gtk.AboutDialog.set_website_label"><a name="method-gtkaboutdialog--set-website-label"></a><h3>gtk.AboutDialog.set_website_label</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_website_label</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>website_label</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>website_label</code></strong> :</span></p></td><td></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_website_label</code>() method sets the
"website_label" property to the string contained in
<em class="parameter"><code>website_label</code></em> if the url hook has been set using the
<a class="link" href="class-gtkaboutdialog.html#function-gtk--about-dialog-set-url-hook" title="gtk.about_dialog_set_url_hook"><code class="function">gtk.about_dialog_set_url_hook</code>()</a>
function.</p></div><div class="refsect2" title="gtk.AboutDialog.get_authors"><a name="method-gtkaboutdialog--get-authors"></a><h3>gtk.AboutDialog.get_authors</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_authors</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list containing the names of the program
authors</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_authors</code>() method returns the
contents of the "authors" property. The "authors" property contains a list
of the names of the authors of the program.</p></div><div class="refsect2" title="gtk.AboutDialog.set_authors"><a name="method-gtkaboutdialog--set-authors"></a><h3>gtk.AboutDialog.set_authors</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_authors</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>authors</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>authors</code></strong> :</span></p></td><td>a list containing the names of the program
authors.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_authors</code>() method sets the
"authors" property to the list contained in
<em class="parameter"><code>authors</code></em>. The author names are displayed in the
authors tab of the secondary credits
dialog. <code class="methodname">set_authors</code>() method will show the
<span class="guibutton">Credits</span> button if it is not displayed.</p></div><div class="refsect2" title="gtk.AboutDialog.get_documenters"><a name="method-gtkaboutdialog--get-documenters"></a><h3>gtk.AboutDialog.get_documenters</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_documenters</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of the program
documenters</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_documenters</code>() method returns
the contents of the "documenters" property which contains a list of the
names of the program documenters.</p></div><div class="refsect2" title="gtk.AboutDialog.set_documenters"><a name="method-gtkaboutdialog--set-documenters"></a><h3>gtk.AboutDialog.set_documenters</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_documenters</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>documenters</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>documenters</code></strong> :</span></p></td><td>a list of the names of the program
documenters</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_documenters</code>() method sets the
"documenters" property to the contents of
<em class="parameter"><code>documenters</code></em>. The documenter names are displayed in
the documenters tab of the secondary credits
dialog. <code class="methodname">set_documenters</code>() method will show the
<span class="guibutton">Credits</span> button if it is not displayed.</p></div><div class="refsect2" title="gtk.AboutDialog.get_artists"><a name="method-gtkaboutdialog--get-artists"></a><h3>gtk.AboutDialog.get_artists</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_artists</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of the names of the program
artists</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_artists</code>() method returns the
contents of the "artists" property which contains a list of the names of the
program artists.</p></div><div class="refsect2" title="gtk.AboutDialog.set_artists"><a name="method-gtkaboutdialog--set-artists"></a><h3>gtk.AboutDialog.set_artists</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_artists</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>artists</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>artists</code></strong> :</span></p></td><td>a list of the names of the program
artists</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_artists</code>() method sets the
"artists" property to the contents of <em class="parameter"><code>artists</code></em>. The
artist names are displayed in the artists tab of the secondary credits
dialog. <code class="methodname">set_artists</code>() method will show the
<span class="guibutton">Credits</span> button if it is not displayed.</p></div><div class="refsect2" title="gtk.AboutDialog.get_translator_credits"><a name="method-gtkaboutdialog--get-translator-credits"></a><h3>gtk.AboutDialog.get_translator_credits</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_translator_credits</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a string containing the translator
credits</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_translator_credits</code>() method
returns the contents of the "translator-credits" property which contains the
credits for the current translation.</p></div><div class="refsect2" title="gtk.AboutDialog.set_translator_credits"><a name="method-gtkaboutdialog--set-translator-credits"></a><h3>gtk.AboutDialog.set_translator_credits</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_translator_credits</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>translator_credits</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>translator_credits</code></strong> :</span></p></td><td>a string containing the current translation
credits</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_translator_credits</code>() method
sets the "translator_credits" property to the value of
<em class="parameter"><code>translator_credits</code></em>. The translator credits are
displayed in the translators tab of the secondary credits dialog.</p><p>The intended use for this string is to display the translator of
the language which is currently used in the user interface. Using the
<code class="function">gettext</code>() function, a simple way to achieve that is to
mark the string for translation.</p><p>It is a good idea to use the customary msgid
"translator-credits" for this purpose, since translators will already know
the purpose of that msgid, and since <a class="link" href="class-gtkaboutdialog.html" title="gtk.AboutDialog"><code class="classname">gtk.AboutDialog</code></a>
will detect if "translator-credits" is untranslated and hide the tab.</p></div><div class="refsect2" title="gtk.AboutDialog.get_logo"><a name="method-gtkaboutdialog--get-logo"></a><h3>gtk.AboutDialog.get_logo</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_logo</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
used as the logo</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_logo</code>() method returns the
contents of the "logo" property which contains a <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a> that
is used as the logo.</p></div><div class="refsect2" title="gtk.AboutDialog.set_logo"><a name="method-gtkaboutdialog--set-logo"></a><h3>gtk.AboutDialog.set_logo</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_logo</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>logo</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>logo</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a> to be
used as the logo</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_logo</code>() method sets the "logo"
property to the <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
contained in <em class="parameter"><code>logo</code></em>. If <em class="parameter"><code>logo</code></em> is
<code class="literal">None</code>, the default window icon set with the <a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon" title="gtk.window_set_default_icon"><code class="function">gtk.window_set_default_icon_list</code>()</a>
function will be used.</p></div><div class="refsect2" title="gtk.AboutDialog.get_logo_icon_name"><a name="method-gtkaboutdialog--get-logo-icon-name"></a><h3>gtk.AboutDialog.get_logo_icon_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_logo_icon_name</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the name of the icon used as the
logo</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_logo_name</code>() method returns the
contents of the "logo-icon-name" property which contains the name of the
icon used as the logo.</p></div><div class="refsect2" title="gtk.AboutDialog.set_logo_icon_name"><a name="method-gtkaboutdialog--set-logo-icon-name"></a><h3>gtk.AboutDialog.set_logo_icon_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_logo_icon_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon_name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>icon_name</code></strong> :</span></p></td><td>the name of an icon or
<code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_logo_icon_name</code>() method sets
the "logo-icon-name" property to the value of
<em class="parameter"><code>icon_name</code></em>. If <em class="parameter"><code>icon_name</code></em> is
<code class="literal">None</code>, the default window icon set with the <a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-list" title="gtk.window_set_default_icon_list"><code class="function">gtk.window_set_default_icon_list</code>()</a>
function will be used.</p></div></div><div class="refsect1" title="Functions"><a name="id3551418"></a><h2>Functions</h2><div class="refsect2" title="gtk.about_dialog_set_email_hook"><a name="function-gtk--about-dialog-set-email-hook"></a><h3>gtk.about_dialog_set_email_hook</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.about_dialog_set_email_hook</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>func</code></strong> :</span></p></td><td> a function to call when an email link is
activated.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>data</code></strong> :</span></p></td><td> data to pass to
<em class="parameter"><code>func</code></em></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.6 and above.</p></div><p>The <code class="function">gtk.about_dialog_set_email_hook</code>
function installs a global function (specified by
<em class="parameter"><code>func</code></em>) to be called whenever the user activates an
email link in an about dialog.</p><p>The signature of the callback function
<em class="parameter"><code>func</code></em> is:</p><pre class="programlisting">
def func(dialog, link, user_data)
</pre><p>where <em class="parameter"><code>link</code></em> is the email address
destination of the activated link, <em class="parameter"><code>dialog</code></em> is the
<a class="link" href="class-gtkaboutdialog.html" title="gtk.AboutDialog"><code class="classname">gtk.AboutDialog</code></a>
containing <em class="parameter"><code>link</code></em> and <em class="parameter"><code>user_data</code></em>
is the <em class="parameter"><code>data</code></em> argument passed to <a class="link" href="class-gtkaboutdialog.html#function-gtk--about-dialog-set-email-hook" title="gtk.about_dialog_set_email_hook"><code class="function">gtk.about_dialog_set_email_hook</code>()</a>.</p></div><div class="refsect2" title="gtk.about_dialog_set_url_hook"><a name="function-gtk--about-dialog-set-url-hook"></a><h3>gtk.about_dialog_set_url_hook</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.about_dialog_set_url_hook</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>func</code></strong> :</span></p></td><td> a function to call when a URL link is
activated.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>data</code></strong> :</span></p></td><td> data to pass to
<em class="parameter"><code>func</code></em></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.6 and above.</p></div><p>The <code class="function">gtk.about_dialog_set_url_hook</code> function
installs a global function (specified by <em class="parameter"><code>func</code></em>) to be
called whenever the user activates a URL link in an about dialog.</p><p>The signature of the callback function
<em class="parameter"><code>func</code></em> is:</p><pre class="programlisting">
def func(dialog, link, user_data)
</pre><p>where <em class="parameter"><code>link</code></em> is the URL destination of the
activated link, <em class="parameter"><code>dialog</code></em> is the <a class="link" href="class-gtkaboutdialog.html" title="gtk.AboutDialog"><code class="classname">gtk.AboutDialog</code></a>
containing <em class="parameter"><code>link</code></em> and <em class="parameter"><code>user_data</code></em>
is the <em class="parameter"><code>data</code></em> argument passed to <a class="link" href="class-gtkaboutdialog.html#function-gtk--about-dialog-set-url-hook" title="gtk.about_dialog_set_url_hook"><code class="function">gtk.about_dialog_set_url_hook</code>()</a>.</p></div></div><div class="refsect1" title="Signals"><a name="id3551084"></a><h2>Signals</h2><div class="refsect2" title='The "activate-link" gtk.AboutDialog Signal'><a name="signal-gtkaboutdialog--activate-link"></a><h3>The "activate-link" gtk.AboutDialog Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>aboutdialog</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>uri</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>aboutdialog</code></em> :</span></p></td><td>the aboutdialog that received the signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td><td>the URI that is activated</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK> method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if any)</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This signal is available in GTK+ 2.24 and above.</p></div><p>The "activate-link" signal is emitted when an URI is activated. Applications may connect to it to override the default behaviour, which is to call
<a class="link" href="gtk-functions.html#function-gtk--show-uri" title="gtk.show_uri"><code class="methodname">gtk.show_uri</code></a>().</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="gtk-class-reference.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-gtkaccelgroup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The gtk Class Reference </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.AccelGroup</td></tr></table></div></body></html>
|