GtkLinkButton

typedef struct _GtkLinkButton GtkLinkButton;

The GtkLinkButton struct contains private data only, and should be manipulated using the functions below.

gtk_link_button_new ()

GtkWidget*          gtk_link_button_new                 (const gchar *uri);

Creates a new GtkLinkButton with the URI as its text.

Since 2.10

gtk_link_button_new_with_label ()

GtkWidget*          gtk_link_button_new_with_label      (const gchar *uri,
                                                         const gchar *label);

Creates a new GtkLinkButton containing a label.

Since 2.10

gtk_link_button_get_uri ()

const gchar*        gtk_link_button_get_uri             (GtkLinkButton *link_button);

Retrieves the URI set using gtk_link_button_set_uri().

Since 2.10

gtk_link_button_set_uri ()

void                gtk_link_button_set_uri             (GtkLinkButton *link_button,
                                                         const gchar *uri);

Sets uri as the URI where the GtkLinkButton points. As a side-effect this unsets the 'visited' state of the button.

Since 2.10

GtkLinkButtonUriFunc ()

void                (*GtkLinkButtonUriFunc)             (GtkLinkButton *button,
                                                         const gchar *link_,
                                                         gpointer user_data);

The type of a function which is called when the GtkLinkButton is clicked.

gtk_link_button_set_uri_hook ()

GtkLinkButtonUriFunc gtk_link_button_set_uri_hook       (GtkLinkButtonUriFunc func,
                                                         gpointer data,
                                                         GDestroyNotify destroy);

Sets func as the function that should be invoked every time a user clicks a GtkLinkButton. This function is called before every callback registered for the "clicked" signal.

Since 2.10

gtk_link_button_get_visited ()

gboolean            gtk_link_button_get_visited         (GtkLinkButton *link_button);

Retrieves the 'visited' state of the URI where the GtkLinkButton points. The button becomes visited when it is clicked. If the URI is changed on the button, the 'visited' state is unset again.

The state may also be changed using gtk_link_button_set_visited().

Since 2.14

gtk_link_button_set_visited ()

void                gtk_link_button_set_visited         (GtkLinkButton *link_button,
                                                         gboolean visited);

Sets the 'visited' state of the URI where the GtkLinkButton points. See gtk_link_button_get_visited() for more details.

Since 2.14

The "uri" property

  "uri"                      gchar*                : Read / Write

The URI bound to this button.

Default value: NULL

Since 2.10

The "visited" property

  "visited"                  gboolean              : Read / Write

The 'visited' state of this button. A visited link is drawn in a different color.

Default value: FALSE

Since 2.14