ActionRow

class ActionRow(**properties: Any)

Superclasses: PreferencesRow, ListBoxRow, Widget, InitiallyUnowned, Object

Subclasses: ComboRow, SpinRow, SwitchRow

Implemented Interfaces: Accessible, Actionable, Buildable, ConstraintTarget

Constructors:

ActionRow(**properties)
new() -> Gtk.Widget

Constructors

class ActionRow

classmethod new() → Widget

Creates a new AdwActionRow.

Methods

class ActionRow

activate() → None

Activates self.

add_prefix(widget: Widget) → None

Adds a prefix widget to self.

Parameters:

widget – a widget

add_suffix(widget: Widget) → None

Adds a suffix widget to self.

Parameters:

widget – a widget

get_activatable_widget() → Widget | None

Gets the widget activated when self is activated.

get_icon_name() → str | None

Gets the icon name for self.

Deprecated since version 1.3: Use add_prefix to add an icon.

get_subtitle() → str | None

Gets the subtitle for self.

get_subtitle_lines() → int

Gets the number of lines at the end of which the subtitle label will be ellipsized.

get_subtitle_selectable() → bool

Gets whether the user can copy the subtitle from the label

Added in version 1.3.

get_title_lines() → int

Gets the number of lines at the end of which the title label will be ellipsized.

remove(widget: Widget) → None

Removes a child from self.

Parameters:

widget – the child to be removed

set_activatable_widget(widget: Widget | None = None) → None

Sets the widget to activate when self is activated.

The row can be activated either by clicking on it, calling activate, or via mnemonics in the title. See the use_underline property to enable mnemonics.

The target widget will be activated by emitting the mnemonic_activate signal on it.

Parameters:

widget – the target widget

set_icon_name(icon_name: str | None = None) → None

Sets the icon name for self.

Deprecated since version 1.3: Use add_prefix to add an icon.

Parameters:

icon_name – the icon name

set_subtitle(subtitle: str) → None

Sets the subtitle for self.

The subtitle is interpreted as Pango markup unless use_markup is set to FALSE.

Parameters:

subtitle – the subtitle

set_subtitle_lines(subtitle_lines: int) → None

Sets the number of lines at the end of which the subtitle label will be ellipsized.

If the value is 0, the number of lines won’t be limited.

Parameters:

subtitle_lines – the number of lines at the end of which the subtitle label will be ellipsized

set_subtitle_selectable(subtitle_selectable: bool) → None

Sets whether the user can copy the subtitle from the label

See also selectable.

Added in version 1.3.

Parameters:

subtitle_selectable – TRUE if the user can copy the subtitle from the label

set_title_lines(title_lines: int) → None

Sets the number of lines at the end of which the title label will be ellipsized.

If the value is 0, the number of lines won’t be limited.

Parameters:

title_lines – the number of lines at the end of which the title label will be ellipsized

Properties

class ActionRow

props.activatable_widget: Widget

The widget to activate when the row is activated.

The row can be activated either by clicking on it, calling activate, or via mnemonics in the title. See the use_underline property to enable mnemonics.

The target widget will be activated by emitting the mnemonic_activate signal on it.

props.icon_name: str

The icon name for this row.

Deprecated since version 1.3: Use add_prefix to add an icon.

props.subtitle: str

The subtitle for this row.

The subtitle is interpreted as Pango markup unless use_markup is set to FALSE.

props.subtitle_lines: int

The number of lines at the end of which the subtitle label will be ellipsized.

If the value is 0, the number of lines won’t be limited.

props.subtitle_selectable: bool

Whether the user can copy the subtitle from the label.

See also selectable.

Added in version 1.3.

props.title_lines: int

The number of lines at the end of which the title label will be ellipsized.

If the value is 0, the number of lines won’t be limited.

Signals

class ActionRow.signals

activated() → None

This signal is emitted after the row has been activated.

Virtual Methods

class ActionRow

do_activate() → None

Activates self.

Fields

class ActionRow

parent_instance