<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<!--ENTITY index-Objects-Grouped SYSTEM "objects_grouped.sgml"-->
<refentry id="GtkAboutDialog">
<refmeta>
<refentrytitle role="top_of_page" id="GtkAboutDialog.top_of_page">GtkAboutDialog</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkAboutDialog</refname>
<refpurpose>Display information about an application</refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkAboutDialog.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gtk/gtk.h&gt;

                    <link linkend="GtkAboutDialog-struct">GtkAboutDialog</link>;
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-about-dialog-new">gtk_about_dialog_new</link>                (void);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-about-dialog-get-name">gtk_about_dialog_get_name</link>           (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-name">gtk_about_dialog_set_name</link>           (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *name);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-about-dialog-get-program-name">gtk_about_dialog_get_program_name</link>   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-program-name">gtk_about_dialog_set_program_name</link>   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *name);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-about-dialog-get-version">gtk_about_dialog_get_version</link>        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-version">gtk_about_dialog_set_version</link>        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *version);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-about-dialog-get-copyright">gtk_about_dialog_get_copyright</link>      (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-copyright">gtk_about_dialog_set_copyright</link>      (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *copyright);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-about-dialog-get-comments">gtk_about_dialog_get_comments</link>       (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-comments">gtk_about_dialog_set_comments</link>       (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *comments);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-about-dialog-get-license">gtk_about_dialog_get_license</link>        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-license">gtk_about_dialog_set_license</link>        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *license);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-about-dialog-get-wrap-license">gtk_about_dialog_get_wrap_license</link>   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-wrap-license">gtk_about_dialog_set_wrap_license</link>   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         <link linkend="gboolean">gboolean</link> wrap_license);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-about-dialog-get-website">gtk_about_dialog_get_website</link>        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-website">gtk_about_dialog_set_website</link>        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *website);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-about-dialog-get-website-label">gtk_about_dialog_get_website_label</link>  (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-website-label">gtk_about_dialog_set_website_label</link>  (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *website_label);
const <link linkend="gchar">gchar</link>* const * <link linkend="gtk-about-dialog-get-authors">gtk_about_dialog_get_authors</link>       (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-authors">gtk_about_dialog_set_authors</link>        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> **authors);
const <link linkend="gchar">gchar</link>* const * <link linkend="gtk-about-dialog-get-artists">gtk_about_dialog_get_artists</link>       (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-artists">gtk_about_dialog_set_artists</link>        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> **artists);
const <link linkend="gchar">gchar</link>* const * <link linkend="gtk-about-dialog-get-documenters">gtk_about_dialog_get_documenters</link>   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-documenters">gtk_about_dialog_set_documenters</link>    (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> **documenters);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-about-dialog-get-translator-credits">gtk_about_dialog_get_translator_credits</link>
                                                        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-translator-credits">gtk_about_dialog_set_translator_credits</link>
                                                        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *translator_credits);
<link linkend="GdkPixbuf">GdkPixbuf</link> *         <link linkend="gtk-about-dialog-get-logo">gtk_about_dialog_get_logo</link>           (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-logo">gtk_about_dialog_set_logo</link>           (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         <link linkend="GdkPixbuf">GdkPixbuf</link> *logo);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-about-dialog-get-logo-icon-name">gtk_about_dialog_get_logo_icon_name</link> (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);
<link linkend="void">void</link>                <link linkend="gtk-about-dialog-set-logo-icon-name">gtk_about_dialog_set_logo_icon_name</link> (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *icon_name);
<link linkend="void">void</link>                (<link linkend="GtkAboutDialogActivateLinkFunc">*GtkAboutDialogActivateLinkFunc</link>)   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *link_,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="GtkAboutDialogActivateLinkFunc">GtkAboutDialogActivateLinkFunc</link>  <link linkend="gtk-about-dialog-set-email-hook">gtk_about_dialog_set_email_hook</link>
                                                        (<link linkend="GtkAboutDialogActivateLinkFunc">GtkAboutDialogActivateLinkFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);
<link linkend="GtkAboutDialogActivateLinkFunc">GtkAboutDialogActivateLinkFunc</link>  <link linkend="gtk-about-dialog-set-url-hook">gtk_about_dialog_set_url_hook</link>
                                                        (<link linkend="GtkAboutDialogActivateLinkFunc">GtkAboutDialogActivateLinkFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);
<link linkend="void">void</link>                <link linkend="gtk-show-about-dialog">gtk_show_about_dialog</link>               (<link linkend="GtkWindow">GtkWindow</link> *parent,
                                                         const <link linkend="gchar">gchar</link> *first_property_name,
                                                         ...);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkAboutDialog.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----<link linkend="GtkBin">GtkBin</link>
                                 +----<link linkend="GtkWindow">GtkWindow</link>
                                       +----<link linkend="GtkDialog">GtkDialog</link>
                                             +----GtkAboutDialog
</synopsis>
</refsect1>



<refsect1 id="GtkAboutDialog.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkAboutDialog implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link> and  <link linkend="GtkBuildable">GtkBuildable</link>.</para>
</refsect1>


<refsect1 id="GtkAboutDialog.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkAboutDialog--artists">artists</link>&quot;                  <link linkend="GStrv">GStrv</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--authors">authors</link>&quot;                  <link linkend="GStrv">GStrv</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--comments">comments</link>&quot;                 <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--copyright">copyright</link>&quot;                <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--documenters">documenters</link>&quot;              <link linkend="GStrv">GStrv</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--license">license</link>&quot;                  <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--logo">logo</link>&quot;                     <link linkend="GdkPixbuf">GdkPixbuf</link>*            : Read / Write
  &quot;<link linkend="GtkAboutDialog--logo-icon-name">logo-icon-name</link>&quot;           <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--program-name">program-name</link>&quot;             <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--translator-credits">translator-credits</link>&quot;       <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--version">version</link>&quot;                  <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--website">website</link>&quot;                  <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--website-label">website-label</link>&quot;            <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkAboutDialog--wrap-license">wrap-license</link>&quot;             <link linkend="gboolean">gboolean</link>              : Read / Write
</synopsis>
</refsect1>



<refsect1 id="GtkAboutDialog.description" role="desc">
<title role="desc.title">Description</title>
<para>
The <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link> 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 <literal>About</literal> option from
the <literal>Help</literal> menu. All parts of the dialog are optional.
</para>
<para>
About dialog often contain links and email addresses. <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
supports this by offering global hooks, which are called when the user
clicks on a link or email address, see <link linkend="gtk-about-dialog-set-email-hook"><function>gtk_about_dialog_set_email_hook()</function></link>
and <link linkend="gtk-about-dialog-set-url-hook"><function>gtk_about_dialog_set_url_hook()</function></link>. Email addresses in the
authors, documenters and artists properties are recognized by looking for
<literal>&lt;user@<!-- -->host&gt;</literal>, URLs are
recognized by looking for <literal>http://url</literal>, with
<literal>url</literal> extending to the next space, tab or line break.
</para>
<para id="gtk-about-dialog-hook-setup">
Since 2.18 <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link> provides default website and email hooks that use
<link linkend="gtk-show-uri"><function>gtk_show_uri()</function></link>.
</para>
<para>
If you want provide your own hooks overriding the default ones, it is important
to do so before setting the website and email URL properties, like this:
</para>
<informalexample><programlisting>
gtk_about_dialog_set_url_hook (GTK_ABOUT_DIALOG (dialog), launch_url, NULL, NULL);
gtk_about_dialog_set_website (GTK_ABOUT_DIALOG (dialog), app_url);
</programlisting></informalexample>
<para>
To disable the default hooks, you can pass <link linkend="NULL--CAPS"><literal>NULL</literal></link> as the hook func. Then,
the <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link> widget will not display the website or the
email addresses as clickable.
</para>
<para>
To make constructing a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link> as convenient as possible, you can
use the function <link linkend="gtk-show-about-dialog"><function>gtk_show_about_dialog()</function></link> which constructs and shows a dialog
and keeps it around so that it can be shown again.
</para>
<para>
Note that GTK+ sets a default title of <literal>_("About &percnt;s")</literal>
on the dialog window (where &percnt;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 <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>, as shown in the following example:
</para>
<informalexample><programlisting>
gtk_show_about_dialog (NULL,
                       "program-name", "ExampleCode",
                       "logo", example_logo,
                       "title" _("About ExampleCode"),
                       NULL);
</programlisting></informalexample>
<para>
Note that prior to GTK+ 2.12, the <link linkend="GtkAboutDialog--program-name"><type>"program-name"</type></link> property
was called "name". This was changed to avoid the conflict with the
<link linkend="GtkWidget--name"><type>"name"</type></link> property.
</para>
</refsect1>

<refsect1 id="GtkAboutDialog.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkAboutDialog-struct" role="struct">
<title>GtkAboutDialog</title>
<indexterm zone="GtkAboutDialog-struct"><primary sortas="AboutDialog">GtkAboutDialog</primary></indexterm><programlisting>typedef struct _GtkAboutDialog GtkAboutDialog;</programlisting>
<para>
The <structname>GtkAboutDialog</structname> struct contains
only private fields and should not be directly accessed.
</para></refsect2>
<refsect2 id="gtk-about-dialog-new" role="function" condition="since:2.6">
<title>gtk_about_dialog_new ()</title>
<indexterm zone="gtk-about-dialog-new" role="2.6"><primary sortas="about_dialog_new">gtk_about_dialog_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_about_dialog_new                (void);</programlisting>
<para>
Creates a new <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a newly created <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-name" role="function" condition="deprecated:2.12: Use gtk_about_dialog_get_program_name() instead.|since:2.6">
<title>gtk_about_dialog_get_name ()</title>
<indexterm zone="gtk-about-dialog-get-name" role="deprecated"><primary sortas="about_dialog_get_name">gtk_about_dialog_get_name</primary></indexterm><indexterm zone="gtk-about-dialog-get-name" role="2.6"><primary sortas="about_dialog_get_name">gtk_about_dialog_get_name</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_about_dialog_get_name           (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<warning><para><literal>gtk_about_dialog_get_name</literal> has been deprecated since version 2.12 and should not be used in newly-written code. Use <link linkend="gtk-about-dialog-get-program-name"><function>gtk_about_dialog_get_program_name()</function></link> instead.</para></warning>
<para>
Returns the program name displayed in the about dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The program name. The string is owned by the about
 dialog and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-name" role="function" condition="deprecated:2.12: Use gtk_about_dialog_set_program_name() instead.|since:2.6">
<title>gtk_about_dialog_set_name ()</title>
<indexterm zone="gtk-about-dialog-set-name" role="deprecated"><primary sortas="about_dialog_set_name">gtk_about_dialog_set_name</primary></indexterm><indexterm zone="gtk-about-dialog-set-name" role="2.6"><primary sortas="about_dialog_set_name">gtk_about_dialog_set_name</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_name           (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *name);</programlisting>
<warning><para><literal>gtk_about_dialog_set_name</literal> has been deprecated since version 2.12 and should not be used in newly-written code. Use <link linkend="gtk-about-dialog-set-program-name"><function>gtk_about_dialog_set_program_name()</function></link> instead.</para></warning>
<para>
Sets the name to display in the about dialog. 
If this is not set, it defaults to <link linkend="g-get-application-name"><function>g_get_application_name()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara> the program name
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-program-name" role="function" condition="since:2.12">
<title>gtk_about_dialog_get_program_name ()</title>
<indexterm zone="gtk-about-dialog-get-program-name" role="2.12"><primary sortas="about_dialog_get_program_name">gtk_about_dialog_get_program_name</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_about_dialog_get_program_name   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the program name displayed in the about dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The program name. The string is owned by the about
 dialog and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.12</para></refsect2>
<refsect2 id="gtk-about-dialog-set-program-name" role="function" condition="since:2.12">
<title>gtk_about_dialog_set_program_name ()</title>
<indexterm zone="gtk-about-dialog-set-program-name" role="2.12"><primary sortas="about_dialog_set_program_name">gtk_about_dialog_set_program_name</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_program_name   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *name);</programlisting>
<para>
Sets the name to display in the about dialog. 
If this is not set, it defaults to <link linkend="g-get-application-name"><function>g_get_application_name()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara> the program name
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.12</para></refsect2>
<refsect2 id="gtk-about-dialog-get-version" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_version ()</title>
<indexterm zone="gtk-about-dialog-get-version" role="2.6"><primary sortas="about_dialog_get_version">gtk_about_dialog_get_version</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_about_dialog_get_version        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the version string.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The version string. The string is owned by the about
 dialog and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-version" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_version ()</title>
<indexterm zone="gtk-about-dialog-set-version" role="2.6"><primary sortas="about_dialog_set_version">gtk_about_dialog_set_version</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_version        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *version);</programlisting>
<para>
Sets the version string to display in the about dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>version</parameter>&#160;:</term>
<listitem><simpara> the version string 
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-copyright" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_copyright ()</title>
<indexterm zone="gtk-about-dialog-get-copyright" role="2.6"><primary sortas="about_dialog_get_copyright">gtk_about_dialog_get_copyright</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_about_dialog_get_copyright      (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the copyright string.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The copyright string. The string is owned by the about
 dialog and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-copyright" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_copyright ()</title>
<indexterm zone="gtk-about-dialog-set-copyright" role="2.6"><primary sortas="about_dialog_set_copyright">gtk_about_dialog_set_copyright</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_copyright      (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *copyright);</programlisting>
<para>
Sets the copyright string to display in the about dialog.
This should be a short string of one or two lines.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>copyright</parameter>&#160;:</term>
<listitem><simpara> the copyright string
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-comments" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_comments ()</title>
<indexterm zone="gtk-about-dialog-get-comments" role="2.6"><primary sortas="about_dialog_get_comments">gtk_about_dialog_get_comments</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_about_dialog_get_comments       (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the comments string.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The comments. The string is owned by the about
 dialog and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-comments" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_comments ()</title>
<indexterm zone="gtk-about-dialog-set-comments" role="2.6"><primary sortas="about_dialog_set_comments">gtk_about_dialog_set_comments</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_comments       (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *comments);</programlisting>
<para>
Sets the comments string to display in the about 
dialog. This should be a short string of one or
two lines.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>comments</parameter>&#160;:</term>
<listitem><simpara> a comments string
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-license" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_license ()</title>
<indexterm zone="gtk-about-dialog-get-license" role="2.6"><primary sortas="about_dialog_get_license">gtk_about_dialog_get_license</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_about_dialog_get_license        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the license information.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The license information. The string is owned by the about
 dialog and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-license" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_license ()</title>
<indexterm zone="gtk-about-dialog-set-license" role="2.6"><primary sortas="about_dialog_set_license">gtk_about_dialog_set_license</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_license        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *license);</programlisting>
<para>
Sets the license information to be displayed in the secondary
license dialog. If <parameter>license</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>, the license button is
hidden.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>license</parameter>&#160;:</term>
<listitem><simpara> the license information or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-wrap-license" role="function" condition="since:2.8">
<title>gtk_about_dialog_get_wrap_license ()</title>
<indexterm zone="gtk-about-dialog-get-wrap-license" role="2.8"><primary sortas="about_dialog_get_wrap_license">gtk_about_dialog_get_wrap_license</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_about_dialog_get_wrap_license   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns whether the license text in <parameter>about</parameter> is 
automatically wrapped.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the license text is wrapped 

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-about-dialog-set-wrap-license" role="function" condition="since:2.8">
<title>gtk_about_dialog_set_wrap_license ()</title>
<indexterm zone="gtk-about-dialog-set-wrap-license" role="2.8"><primary sortas="about_dialog_set_wrap_license">gtk_about_dialog_set_wrap_license</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_wrap_license   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         <link linkend="gboolean">gboolean</link> wrap_license);</programlisting>
<para>
Sets whether the license text in <parameter>about</parameter> is 
automatically wrapped.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>wrap_license</parameter>&#160;:</term>
<listitem><simpara> whether to wrap the license
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-about-dialog-get-website" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_website ()</title>
<indexterm zone="gtk-about-dialog-get-website" role="2.6"><primary sortas="about_dialog_get_website">gtk_about_dialog_get_website</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_about_dialog_get_website        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the website URL.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The website URL. The string is owned by the about
 dialog and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-website" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_website ()</title>
<indexterm zone="gtk-about-dialog-set-website" role="2.6"><primary sortas="about_dialog_set_website">gtk_about_dialog_set_website</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_website        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *website);</programlisting>
<para>
Sets the URL to use for the website link.
</para>
<para>
Note that that the hook functions need to be set up
before calling this function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>website</parameter>&#160;:</term>
<listitem><simpara> a URL string starting with "http://"
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-website-label" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_website_label ()</title>
<indexterm zone="gtk-about-dialog-get-website-label" role="2.6"><primary sortas="about_dialog_get_website_label">gtk_about_dialog_get_website_label</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_about_dialog_get_website_label  (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the label used for the website link.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The label used for the website link. The string is owned by the about
 dialog and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-website-label" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_website_label ()</title>
<indexterm zone="gtk-about-dialog-set-website-label" role="2.6"><primary sortas="about_dialog_set_website_label">gtk_about_dialog_set_website_label</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_website_label  (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *website_label);</programlisting>
<para>
Sets the label to be used for the website link.
It defaults to the website URL.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>website_label</parameter>&#160;:</term>
<listitem><simpara> the label used for the website link
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-authors" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_authors ()</title>
<indexterm zone="gtk-about-dialog-get-authors" role="2.6"><primary sortas="about_dialog_get_authors">gtk_about_dialog_get_authors</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* const * gtk_about_dialog_get_authors       (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the string which are displayed in the authors tab
of the secondary credits dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated string array containing
 the authors. The array is owned by the about dialog 
 and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-authors" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_authors ()</title>
<indexterm zone="gtk-about-dialog-set-authors" role="2.6"><primary sortas="about_dialog_set_authors">gtk_about_dialog_set_authors</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_authors        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> **authors);</programlisting>
<para>
Sets the strings which are displayed in the authors tab
of the secondary credits dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>authors</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated array of strings 
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-artists" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_artists ()</title>
<indexterm zone="gtk-about-dialog-get-artists" role="2.6"><primary sortas="about_dialog_get_artists">gtk_about_dialog_get_artists</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* const * gtk_about_dialog_get_artists       (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the string which are displayed in the artists tab
of the secondary credits dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated string array containing
 the artists. The array is owned by the about dialog 
 and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-artists" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_artists ()</title>
<indexterm zone="gtk-about-dialog-set-artists" role="2.6"><primary sortas="about_dialog_set_artists">gtk_about_dialog_set_artists</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_artists        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> **artists);</programlisting>
<para>
Sets the strings which are displayed in the artists tab
of the secondary credits dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>artists</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated array of strings 
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-documenters" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_documenters ()</title>
<indexterm zone="gtk-about-dialog-get-documenters" role="2.6"><primary sortas="about_dialog_get_documenters">gtk_about_dialog_get_documenters</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* const * gtk_about_dialog_get_documenters   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the string which are displayed in the documenters 
tab of the secondary credits dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated string array containing
 the documenters. The array is owned by the about dialog 
 and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-documenters" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_documenters ()</title>
<indexterm zone="gtk-about-dialog-set-documenters" role="2.6"><primary sortas="about_dialog_set_documenters">gtk_about_dialog_set_documenters</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_documenters    (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> **documenters);</programlisting>
<para>
Sets the strings which are displayed in the documenters tab
of the secondary credits dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>documenters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated array of strings 
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-translator-credits" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_translator_credits ()</title>
<indexterm zone="gtk-about-dialog-get-translator-credits" role="2.6"><primary sortas="about_dialog_get_translator_credits">gtk_about_dialog_get_translator_credits</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_about_dialog_get_translator_credits
                                                        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the translator credits string which is displayed
in the translators tab of the secondary credits dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The translator credits string. The string is
  owned by the about dialog and must not be modified.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-translator-credits" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_translator_credits ()</title>
<indexterm zone="gtk-about-dialog-set-translator-credits" role="2.6"><primary sortas="about_dialog_set_translator_credits">gtk_about_dialog_set_translator_credits</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_translator_credits
                                                        (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *translator_credits);</programlisting>
<para>
Sets the translator credits string which is displayed in
the translators tab of the secondary credits dialog.
</para>
<para>
The intended use for this string is to display the translator
of the language which is currently used in the user interface.
Using <link linkend="gettext"><function>gettext()</function></link>, a simple way to achieve that is to mark the
string for translation:
<informalexample><programlisting>
 gtk_about_dialog_set_translator_credits (about, _("translator-credits"));
</programlisting></informalexample>
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 <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link> will detect if "translator-credits" is untranslated
and hide the tab.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>translator_credits</parameter>&#160;:</term>
<listitem><simpara> the translator credits
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-logo" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_logo ()</title>
<indexterm zone="gtk-about-dialog-get-logo" role="2.6"><primary sortas="about_dialog_get_logo">gtk_about_dialog_get_logo</primary></indexterm><programlisting><link linkend="GdkPixbuf">GdkPixbuf</link> *         gtk_about_dialog_get_logo           (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the pixbuf displayed as logo in the about dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the pixbuf displayed as logo. The pixbuf is
  owned by the about dialog. If you want to keep a reference
  to it, you have to call <link linkend="g-object-ref"><function>g_object_ref()</function></link> on it.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-logo" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_logo ()</title>
<indexterm zone="gtk-about-dialog-set-logo" role="2.6"><primary sortas="about_dialog_set_logo">gtk_about_dialog_set_logo</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_logo           (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         <link linkend="GdkPixbuf">GdkPixbuf</link> *logo);</programlisting>
<para>
Sets the pixbuf to be displayed as logo in 
the about dialog. If it is <link linkend="NULL--CAPS"><literal>NULL</literal></link>, the default
window icon set with <link linkend="gtk-window-set-default-icon"><function>gtk_window_set_default_icon()</function></link>
will be used.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>logo</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GdkPixbuf"><type>GdkPixbuf</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-get-logo-icon-name" role="function" condition="since:2.6">
<title>gtk_about_dialog_get_logo_icon_name ()</title>
<indexterm zone="gtk-about-dialog-get-logo-icon-name" role="2.6"><primary sortas="about_dialog_get_logo_icon_name">gtk_about_dialog_get_logo_icon_name</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_about_dialog_get_logo_icon_name (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about);</programlisting>
<para>
Returns the icon name displayed as logo in the about dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the icon name displayed as logo. The string is
  owned by the dialog. If you want to keep a reference
  to it, you have to call <link linkend="g-strdup"><function>g_strdup()</function></link> on it.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-logo-icon-name" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_logo_icon_name ()</title>
<indexterm zone="gtk-about-dialog-set-logo-icon-name" role="2.6"><primary sortas="about_dialog_set_logo_icon_name">gtk_about_dialog_set_logo_icon_name</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_about_dialog_set_logo_icon_name (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *icon_name);</programlisting>
<para>
Sets the pixbuf to be displayed as logo in 
the about dialog. If it is <link linkend="NULL--CAPS"><literal>NULL</literal></link>, the default
window icon set with <link linkend="gtk-window-set-default-icon"><function>gtk_window_set_default_icon()</function></link>
will be used.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>icon_name</parameter>&#160;:</term>
<listitem><simpara> an icon name, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="GtkAboutDialogActivateLinkFunc" role="function">
<title>GtkAboutDialogActivateLinkFunc ()</title>
<indexterm zone="GtkAboutDialogActivateLinkFunc"><primary sortas="AboutDialogActivateLinkFunc">GtkAboutDialogActivateLinkFunc</primary></indexterm><programlisting><link linkend="void">void</link>                (*GtkAboutDialogActivateLinkFunc)   (<link linkend="GtkAboutDialog">GtkAboutDialog</link> *about,
                                                         const <link linkend="gchar">gchar</link> *link_,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
The type of a function which is called when a URL or email
link is activated.
</para><variablelist role="params">
<varlistentry><term><parameter>about</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="GtkAboutDialog"><type>GtkAboutDialog</type></link> in which the link was activated
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>link_</parameter>&#160;:</term>
<listitem><simpara>the URL or email address to which the activated link points
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>user data that was passed when the function was registered
  with <link linkend="gtk-about-dialog-set-email-hook"><function>gtk_about_dialog_set_email_hook()</function></link> or
  <link linkend="gtk-about-dialog-set-url-hook"><function>gtk_about_dialog_set_url_hook()</function></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-about-dialog-set-email-hook" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_email_hook ()</title>
<indexterm zone="gtk-about-dialog-set-email-hook" role="2.6"><primary sortas="about_dialog_set_email_hook">gtk_about_dialog_set_email_hook</primary></indexterm><programlisting><link linkend="GtkAboutDialogActivateLinkFunc">GtkAboutDialogActivateLinkFunc</link>  gtk_about_dialog_set_email_hook
                                                        (<link linkend="GtkAboutDialogActivateLinkFunc">GtkAboutDialogActivateLinkFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);</programlisting>
<para>
Installs a global function to be called whenever the user activates an
email link in an about dialog. 
</para>
<para>
Since 2.18 there exists a default function which uses <link linkend="gtk-show-uri"><function>gtk_show_uri()</function></link>. To
deactivate it, you can pass <link linkend="NULL--CAPS"><literal>NULL</literal></link> for <parameter>func</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a function to call when an email link is activated.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>func</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>destroy</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GDestroyNotify"><type>GDestroyNotify</type></link> for <parameter>data</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the previous email hook.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-about-dialog-set-url-hook" role="function" condition="since:2.6">
<title>gtk_about_dialog_set_url_hook ()</title>
<indexterm zone="gtk-about-dialog-set-url-hook" role="2.6"><primary sortas="about_dialog_set_url_hook">gtk_about_dialog_set_url_hook</primary></indexterm><programlisting><link linkend="GtkAboutDialogActivateLinkFunc">GtkAboutDialogActivateLinkFunc</link>  gtk_about_dialog_set_url_hook
                                                        (<link linkend="GtkAboutDialogActivateLinkFunc">GtkAboutDialogActivateLinkFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);</programlisting>
<para>
Installs a global function to be called whenever the user activates a
URL link in an about dialog.
</para>
<para>
Since 2.18 there exists a default function which uses <link linkend="gtk-show-uri"><function>gtk_show_uri()</function></link>. To
deactivate it, you can pass <link linkend="NULL--CAPS"><literal>NULL</literal></link> for <parameter>func</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a function to call when a URL link is activated.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>func</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>destroy</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GDestroyNotify"><type>GDestroyNotify</type></link> for <parameter>data</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the previous URL hook.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-show-about-dialog" role="function" condition="since:2.6">
<title>gtk_show_about_dialog ()</title>
<indexterm zone="gtk-show-about-dialog" role="2.6"><primary sortas="show_about_dialog">gtk_show_about_dialog</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_show_about_dialog               (<link linkend="GtkWindow">GtkWindow</link> *parent,
                                                         const <link linkend="gchar">gchar</link> *first_property_name,
                                                         ...);</programlisting>
<para>
This is a convenience function for showing an application's about box.
The constructed dialog is associated with the parent window and 
reused for future invocations of this function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>parent</parameter>&#160;:</term>
<listitem><simpara> transient parent, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> for none
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>first_property_name</parameter>&#160;:</term>
<listitem><simpara> the name of the first property 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara> value of first property, followed by more properties, <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>

</refsect1>
<refsect1 id="GtkAboutDialog.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkAboutDialog--artists" role="property"><title>The <literal>&quot;artists&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--artists" role="2.6"><primary sortas="AboutDialog:artists">GtkAboutDialog:artists</primary></indexterm><programlisting>  &quot;artists&quot;                  <link linkend="GStrv">GStrv</link>*                : Read / Write</programlisting>
<para>
The people who contributed artwork to the program, as a <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated array of strings.
Each string may contain email addresses and URLs, which will be displayed
as links, see the introduction for more details.</para>
<para>
</para><para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--authors" role="property"><title>The <literal>&quot;authors&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--authors" role="2.6"><primary sortas="AboutDialog:authors">GtkAboutDialog:authors</primary></indexterm><programlisting>  &quot;authors&quot;                  <link linkend="GStrv">GStrv</link>*                : Read / Write</programlisting>
<para>
The authors of the program, as a <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated array of strings.
Each string may contain email addresses and URLs, which will be displayed
as links, see the introduction for more details.</para>
<para>
</para><para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--comments" role="property"><title>The <literal>&quot;comments&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--comments" role="2.6"><primary sortas="AboutDialog:comments">GtkAboutDialog:comments</primary></indexterm><programlisting>  &quot;comments&quot;                 <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
Comments about the program. This string is displayed in a label
in the main dialog, thus it should be a short explanation of
the main purpose of the program, not a detailed list of features.</para>
<para>
</para><para>Default value: NULL</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--copyright" role="property"><title>The <literal>&quot;copyright&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--copyright" role="2.6"><primary sortas="AboutDialog:copyright">GtkAboutDialog:copyright</primary></indexterm><programlisting>  &quot;copyright&quot;                <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
Copyright information for the program.</para>
<para>
</para><para>Default value: NULL</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--documenters" role="property"><title>The <literal>&quot;documenters&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--documenters" role="2.6"><primary sortas="AboutDialog:documenters">GtkAboutDialog:documenters</primary></indexterm><programlisting>  &quot;documenters&quot;              <link linkend="GStrv">GStrv</link>*                : Read / Write</programlisting>
<para>
The people documenting the program, as a <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated array of strings.
Each string may contain email addresses and URLs, which will be displayed
as links, see the introduction for more details.</para>
<para>
</para><para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--license" role="property"><title>The <literal>&quot;license&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--license" role="2.6"><primary sortas="AboutDialog:license">GtkAboutDialog:license</primary></indexterm><programlisting>  &quot;license&quot;                  <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
The license of the program. This string is displayed in a 
text view in a secondary dialog, therefore it is fine to use
a long multi-paragraph text. Note that the text is only wrapped
in the text view if the "wrap-license" property is set to <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>;
otherwise the text itself must contain the intended linebreaks.</para>
<para>
</para><para>Default value: NULL</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--logo" role="property"><title>The <literal>&quot;logo&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--logo" role="2.6"><primary sortas="AboutDialog:logo">GtkAboutDialog:logo</primary></indexterm><programlisting>  &quot;logo&quot;                     <link linkend="GdkPixbuf">GdkPixbuf</link>*            : Read / Write</programlisting>
<para>
A logo for the about box. If this is not set, it defaults to 
<link linkend="gtk-window-get-default-icon-list"><function>gtk_window_get_default_icon_list()</function></link>.</para>
<para>
</para><para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--logo-icon-name" role="property"><title>The <literal>&quot;logo-icon-name&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--logo-icon-name" role="2.6"><primary sortas="AboutDialog:logo-icon-name">GtkAboutDialog:logo-icon-name</primary></indexterm><programlisting>  &quot;logo-icon-name&quot;           <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
A named icon to use as the logo for the about box. This property
overrides the <link linkend="GtkAboutDialog--logo">logo</link> property.</para>
<para>
</para><para>Default value: NULL</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--program-name" role="property"><title>The <literal>&quot;program-name&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--program-name" role="2.12"><primary sortas="AboutDialog:program-name">GtkAboutDialog:program-name</primary></indexterm><programlisting>  &quot;program-name&quot;             <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
The name of the program. 
If this is not set, it defaults to <link linkend="g-get-application-name"><function>g_get_application_name()</function></link>.</para>
<para>
</para><para>Default value: NULL</para>
<para>Since 2.12</para>
</refsect2>
<refsect2 id="GtkAboutDialog--translator-credits" role="property"><title>The <literal>&quot;translator-credits&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--translator-credits" role="2.6"><primary sortas="AboutDialog:translator-credits">GtkAboutDialog:translator-credits</primary></indexterm><programlisting>  &quot;translator-credits&quot;       <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
Credits to the translators. This string should be marked as translatable.
The string may contain email addresses and URLs, which will be displayed
as links, see the introduction for more details.</para>
<para>
</para><para>Default value: NULL</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--version" role="property"><title>The <literal>&quot;version&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--version" role="2.6"><primary sortas="AboutDialog:version">GtkAboutDialog:version</primary></indexterm><programlisting>  &quot;version&quot;                  <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
The version of the program.</para>
<para>
</para><para>Default value: NULL</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--website" role="property"><title>The <literal>&quot;website&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--website" role="2.6"><primary sortas="AboutDialog:website">GtkAboutDialog:website</primary></indexterm><programlisting>  &quot;website&quot;                  <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
The URL for the link to the website of the program. 
This should be a string starting with "http://.</para>
<para>
</para><para>Default value: NULL</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--website-label" role="property"><title>The <literal>&quot;website-label&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--website-label" role="2.6"><primary sortas="AboutDialog:website-label">GtkAboutDialog:website-label</primary></indexterm><programlisting>  &quot;website-label&quot;            <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
The label for the link to the website of the program. If this is not set, 
it defaults to the URL specified in the 
<link linkend="GtkAboutDialog--website">website</link> property.</para>
<para>
</para><para>Default value: NULL</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkAboutDialog--wrap-license" role="property"><title>The <literal>&quot;wrap-license&quot;</literal> property</title>
<indexterm zone="GtkAboutDialog--wrap-license" role="2.8"><primary sortas="AboutDialog:wrap-license">GtkAboutDialog:wrap-license</primary></indexterm><programlisting>  &quot;wrap-license&quot;             <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
Whether to wrap the text in the license dialog.</para>
<para>
</para><para>Default value: FALSE</para>
<para>Since 2.8</para>
</refsect2>

</refsect1>



<refsect1 id="GtkAboutDialog.see-also">
<title>See Also</title>
<para>
<link linkend="GTK-STOCK-ABOUT--CAPS"><type>GTK_STOCK_ABOUT</type></link>
</para>
</refsect1>

</refentry>
