Add a note about hook setup. (#425004, Emmanuele Bassi)

2007-11-26  Matthias Clasen  <mclasen@redhat.com>

        * gtk/gtkaboutdialog.c (gtk_about_dialog_set_website): Add a note
        about hook setup.  (#425004, Emmanuele Bassi)



svn path=/trunk/; revision=19050
This commit is contained in:
Matthias Clasen 2007-11-26 16:48:21 +00:00 committed by Matthias Clasen
parent 643e4f3d0e
commit 259244deda
4 changed files with 26 additions and 0 deletions

View File

@ -1,3 +1,8 @@
2007-11-26 Matthias Clasen <mclasen@redhat.com>
* gtk/gtkaboutdialog.c (gtk_about_dialog_set_website): Add a note
about hook setup. (#425004, Emmanuele Bassi)
2007-11-26 Tor Lillqvist <tml@novell.com>
* gdk/win32/gdkwindow-win32.c (gdk_window_fullscreen): Use the

View File

@ -1,3 +1,8 @@
2007-11-26 Matthias Clasen <mclasen@redhat.com>
* gtk/tmpl/gtkaboutdialog.sgml: Add note about hook setup
to the introduction.
2007-11-25 Matthias Clasen <mclasen@redhat.com>
* gtk/tmpl/gtkdialog.sgml: Move signal docs inline.

View File

@ -23,6 +23,19 @@ authors, documenters and artists properties are recognized by looking for
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">
When setting the website and email hooks for the #GtkAboutDialog widget,
you should remember that the order is important: you should set the hook
functions 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>
Otherwise the GtkAboutDialog widget will not display the website and the
email addresses as clickable.
</para>
<para>
To make constructing a #GtkAboutDialog as convenient as possible, you can
use the function gtk_show_about_dialog() which constructs and shows a dialog

View File

@ -1125,6 +1125,9 @@ gtk_about_dialog_get_website (GtkAboutDialog *about)
*
* Sets the URL to use for the website link.
*
* Note that that the hook functions need to be set up
* before calling this function.
*
* Since: 2.6
**/
void