LinkButton

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_link_button_get_type ()" ) ]
public sealed class LinkButton : Button, Accessible, Actionable, Buildable, ConstraintTarget

A button with a hyperlink.

It is useful to show quick links to resources.

A link button is created by calling either [ctor@Gtk.LinkButton.new] or [ctor@Gtk.LinkButton.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 [method@Gtk.LinkButton.set_uri].

By default, `GtkLinkButton` calls [method@Gtk.FileLauncher.launch] when the button is clicked. This behaviour can be overridden by connecting to the [signal@Gtk.LinkButton:GtkLinkButton:activate-link] signal and returning true from the signal handler.

Shortcuts and Gestures

`GtkLinkButton` supports the following keyboard shortcuts:

<kbd>Shift</kbd>+<kbd>F10</kbd> or <kbd>Menu</kbd> opens the context menu.

Actions

`GtkLinkButton` defines a set of built-in actions:

`clipboard.copy` copies the url to the clipboard.
`menu.popup` opens the context menu.

CSS nodes

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

Accessibility

`GtkLinkButton` uses the [enum@Gtk.AccessibleRole.link] role.

Namespace: Gtk

Package: gtk4

Content:

Properties:

public string uri { get; set; }
The URI bound to this button.
public bool visited { get; set; }
The 'visited' state of this button.

Creation methods:

public LinkButton (string uri)
Creates a new `GtkLinkButton` with the URI as its text.
public LinkButton.with_label (string uri, string? label)
Creates a new `GtkLinkButton` containing a label.

Methods:

public unowned string get_uri ()
Retrieves the URI of the `GtkLinkButton`.
public bool get_visited ()
Retrieves the “visited” state of the `GtkLinkButton`.
public void set_uri (string uri)
Sets uri as the URI where the `GtkLinkButton` points.
public void set_visited (bool visited)
Sets the “visited” state of the `GtkLinkButton`.

Signals:

public signal bool activate_link ()
Emitted each time the `GtkLinkButton` is clicked.

Inherited Members:

All known members inherited from class Gtk.Button

All known members inherited from class Gtk.Widget

All known members inherited from class GLib.Object

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.Actionable

All known members inherited from interface Gtk.Buildable