Skip to main content

Variable: GtkLinkButton

const GtkLinkButton: "GtkLinkButton"

Defined in: generated/jsx.ts:16908

A button with a hyperlink.

An example GtkLinkButton

It is useful to show quick links to resources.

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

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

Shortcuts and Gestures

GtkLinkButton supports the following keyboard shortcuts:

  • Shift+F10 or Menu 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 Gtk.AccessibleRole.link role.