"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [

]>

<chapter id="gtk-migrating-GtkLinkButton">

  <title>Migrating from GnomeHRef to GtkLinkButton</title>

  <para>

    Since version 2.10, GTK+ provides the #GtkLinkButton widget as a

    replacement for the <structname>GnomeHRef</structname> widget

    in the libgnomeui library.

  </para>

  <para>

    Porting an application from <structname>GnomeHRef</structname> to

    #GtkLinkButton is very simple. #GtkLinkButton does not have a

    default action for #GtkButton::clicked signal. So instead of simply 

    creating the widget

    <informalexample><programlisting>

      GtkWidget *button;

      button = gnome_href_new (url, "");

    </programlisting></informalexample>

    you will have to handle the activation of the #GtkLinkButton, using

    the ::clicked signal for instance

    <informalexample><programlisting>

      static void

      link_button_clicked_cb (GtkWidget *widget,

                              gpointer   data)

      {

        const gchar *link;

	link = gtk_link_button_get_uri (GTK_LINK_BUTTON (widget));

	open_browser_at_url (link);

      }

      /* ... */

        GtkWidget *button;

	button = gtk_link_button_new (url);

	g_signal_connect (button, "clicked",

	                  G_CALLBACK (link_button_clicked_cb), NULL);

     </programlisting></informalexample>

    If you have more than one #GtkLinkButton instead of connecting

    a signal to each one, you can use a "hook function" which will be

    called whenever a user activates a link button

    <informalexample><programlisting>

      static void

      link_button_hook (GtkLinkButton *button,

                        const gchar   *link,

			gpointer       user_data)

      {

        open_browser_at_url (link);

      }

      /* ... */

        GtkWidget *button1 = gtk_link_button_new (uri1);

	GtkWidget *button2 = gtk_link_button_new (uri2);

        gtk_link_button_set_uri_hook (link_button_hook, NULL, NULL);

    </programlisting></informalexample>

  </para>

  <para>

    Starting with GTK+ 2.16, it is no longer necessary to set up a uri hook

    manually, since GTK+ now defaults to calling gtk_show_uri() if no uri

    hook has been set.

  </para>

</chapter>

Local variables:

mode: sgml

sgml-parent-document: ("gtk-docs.sgml" "book" "part" "chapter")

End:

-->