gtk:button, gtk:widget, gobject:initially-unowned, gtk:accessible, gtk:buildable, gtk:constraint-target, gtk:actionable, gobject:object, common-lisp:standard-object, common-lisp:t

None

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. 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. The gtk:link-button implementation uses the :link role of the gtk:accessible-role enumeration.

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.