Package: gtk

Class gtk:link-button

Superclasses

Documented Subclasses

None

Direct Slots

uri
The uri property of type :string (Read / Write)
The URI bound to this button.
Default value: nil
visited
The visited property of type :boolean (Read / Write)
The visited state of this button. A visited link is drawn in a different color.
Default value: false

Details

The gtk:link-button widget is a gtk:button widget 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 the gtk:link-button-new or gtk:link-button-new-with-label function. If using the former, the URI you pass to the constructor is used as a label for the widget.

Figure: GtkLinkButton

The URI bound to a gtk:link-button widget can be set specifically or retrieved using the gtk:link-button-uri function.

By default, the gtk:link-button widget calls the gtk:file-launcher-launch function 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

The gtk:link-button implementation has a single CSS node with name button. To differentiate it from a plain gtk:button widget, it gets the .link style class.

Accessibility

The gtk:link-button implementation uses the :link role of the gtk:accessible-role enumeration.

Signal Details

The "activate-link" signal
lambda (button)    :run-last      
button
The gtk:link-button widget that emitted the signal.
The signal is emitted each time the link button has been clicked. The default handler will call the gtk:file-launcher-launch function 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.
 

Returned by

Slot Access Functions

Inherited Slot Access Functions

See also

2025-2-22