gtk:button, gtk:bin, gtk:container, gtk:widget, gtk:buildable, gtk:actionable, gtk:activatable, gobject:object, common-lisp:standard-object, common-lisp:t

None

A 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 functions. 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:show-uri 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 "activate-link" signal

lambda (button)    :run-last      

The signal is emitted each time the link button has been clicked. The default handler will call the gtk:show-uri 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.

button

The gtk:link-button widget that emitted the signal.