GtkLinkButton

GtkLinkButton — Create buttons bound to a URL

Properties

gchar * uri Read / Write
gboolean visited Read / Write

Signals

gboolean activate-link Run Last

Actions

  menu.popup  
  clipboard.copy  

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkButton
                ╰── GtkLinkButton

Implemented Interfaces

GtkLinkButton implements AtkImplementorIface, GtkBuildable, GtkConstraintTarget and GtkActionable.

Includes

#include <gtk/gtk.h>

Description

A GtkLinkButton is a GtkButton with a hyperlink, similar to the one used by web browsers, which triggers an action when clicked. It is useful to show quick links to resources.

A link button is created by calling either gtk_link_button_new() or gtk_link_button_new_with_label(). If using the former, the URI you pass to the constructor is used as a label for the widget.

The URI bound to a GtkLinkButton can be set specifically using gtk_link_button_set_uri(), and retrieved using gtk_link_button_get_uri().

By default, GtkLinkButton calls gtk_show_uri() when the button is clicked. This behaviour can be overridden by connecting to the “activate-link” signal and returning TRUE from the signal handler.

CSS nodes

GtkLinkButton has a single CSS node with name button. To differentiate it from a plain GtkButton, it gets the .link style class.

Functions

gtk_link_button_new ()

GtkWidget *
gtk_link_button_new (const gchar *uri);

Creates a new GtkLinkButton with the URI as its text.

Parameters

uri

a valid URI

 

Returns

a new link button widget.


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.

Parameters

uri

a valid URI

 

label

the text of the button.

[allow-none]

Returns

a new link button widget.

[transfer none]


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().

Parameters

link_button

a GtkLinkButton

 

Returns

a valid URI. The returned string is owned by the link button and should not be modified or freed.


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.

Parameters

link_button

a GtkLinkButton

 

uri

a valid URI

 

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().

Parameters

link_button

a GtkLinkButton

 

Returns

TRUE if the link has been visited, FALSE otherwise


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.

Parameters

link_button

a GtkLinkButton

 

visited

the new “visited” state

 

Types and Values

GtkLinkButton

typedef struct _GtkLinkButton GtkLinkButton;

Property Details

The “uri” property

  “uri”                      gchar *

The URI bound to this button.

Owner: GtkLinkButton

Flags: Read / Write

Default value: NULL


The “visited” property

  “visited”                  gboolean

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

Owner: GtkLinkButton

Flags: Read / Write

Default value: FALSE

Signal Details

The “activate-link” signal

gboolean
user_function (GtkLinkButton *button,
               gpointer       user_data)

The ::activate-link signal is emitted each time the GtkLinkButton has been clicked.

The default handler will call gtk_show_uri() with the URI stored inside the “uri” property.

To override the default behavior, you can connect to the ::activate-link signal and stop the propagation of the signal by returning TRUE from your handler.

Parameters

button

the GtkLinkButton that emitted the signal

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last

Action Details

The “menu.popup” action

Opens the context menu.


The “clipboard.copy” action

Copies the url to the clipboard.

See Also

GtkButton