4.2 KiB
STRUCT
LinkButton
A GtkLinkButton is 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::activate-link] signal and returning %TRUE from
the signal handler.
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_ACCESSIBLE_ROLE_LINK role.
Properties
updateFunctions
Additional update functions for type extensions.
appearFunctions
Additional appear functions for type extensions.
accessibleRole
The accessible role of the given GtkAccessible implementation.
The accessible role cannot be changed once set.
actionName
action-name
canShrink
Whether the size of the button can be made smaller than the natural size of its contents.
For text buttons, setting this property will allow ellipsizing the label.
If the contents of a button are an icon or a custom widget, setting this property has no effect.
child
The child widget.
hasFrame
Whether the button has a frame.
iconName
The name of the icon used to automatically populate the button.
label
Text of the label inside the button, if the button contains a label widget.
uri
The URI bound to this button.
useUnderline
If set, an underline in the text indicates that the following character is to be used as mnemonic.
visited
The 'visited' state of this button.
A visited link is drawn in a different color.
activate
Emitted to animate press then release.
This is an action signal. Applications should never connect to this signal, but use the [signal@Gtk.Button::clicked] signal.
The default bindings for this signal are all forms of the ␣ and Enter keys.
clicked
Emitted when the button has been activated (pressed and released).
app
The application.
window
The window.
Methods
init(uri:)
Initialize LinkButton.
container(modifiers:)
Get the widget's view storage.
- Parameter modifiers: The view modifiers.
- Returns: The view storage.
update(_:modifiers:updateProperties:)
Update the widget's view storage.
- Parameters:
- storage: The view storage.
- modifiers: The view modifiers.
- updateProperties: Whether to update the view's properties.
accessibleRole(_:)
The accessible role of the given GtkAccessible implementation.
The accessible role cannot be changed once set.
actionName(_:)
action-name
canShrink(_:)
Whether the size of the button can be made smaller than the natural size of its contents.
For text buttons, setting this property will allow ellipsizing the label.
If the contents of a button are an icon or a custom widget, setting this property has no effect.
child(_:)
The child widget.
hasFrame(_:)
Whether the button has a frame.
iconName(_:)
The name of the icon used to automatically populate the button.
label(_:)
Text of the label inside the button, if the button contains a label widget.
uri(_:)
The URI bound to this button.
useUnderline(_:)
If set, an underline in the text indicates that the following character is to be used as mnemonic.
visited(_:)
The 'visited' state of this button.
A visited link is drawn in a different color.
activate(_:)
Emitted to animate press then release.
This is an action signal. Applications should never connect to this signal, but use the [signal@Gtk.Button::clicked] signal.
The default bindings for this signal are all forms of the ␣ and Enter keys.
clicked(_:)
Emitted when the button has been activated (pressed and released).