LinkButton

class LinkButton(**properties: Any)

Superclasses: Button, Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Actionable, Buildable, ConstraintTarget

Constructors:

LinkButton(**properties)
new(uri:str) -> Gtk.Widget
new_with_label(uri:str, label:str=None) -> Gtk.Widget

Constructors

class LinkButton

classmethod new(uri: str) → Widget

Creates a new GtkLinkButton with the URI as its text.

Parameters:: uri – a valid URI

classmethod new_with_label(uri: str, label: str | None = None) → Widget

Creates a new GtkLinkButton containing a label.

Parameters:

uri – a valid URI
label – the text of the button

Methods

class LinkButton

get_uri() → str: Retrieves the URI of the GtkLinkButton.

get_visited() → bool

Retrieves the “visited” state of the GtkLinkButton.

The button becomes visited when it is clicked. If the URI is changed on the button, the “visited” state is unset again.

The state may also be changed using set_visited.

set_uri(uri: str) → None

Sets uri as the URI where the GtkLinkButton points.

As a side-effect this unsets the “visited” state of the button.

Parameters:: uri – a valid URI

set_visited(visited: bool) → None

Sets the “visited” state of the GtkLinkButton.

See get_visited for more details.

Parameters:: visited – the new “visited” state

Properties

class LinkButton

props.uri: str: The URI bound to this button.

props.visited: bool

The ‘visited’ state of this button.

A visited link is drawn in a different color.

Signals

class LinkButton.signals

activate_link() → bool

Emitted each time the GtkLinkButton is clicked.

The default handler will call launch 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.