ButtonRow#

Added in version 1.6.

class ButtonRow(**properties: Any)#

Superclasses: PreferencesRow, ListBoxRow, Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Actionable, Buildable, ConstraintTarget

A ListBoxRow that looks like a button.

https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/button-rows.png

The AdwButtonRow widget has a title and two icons: before and after the title.

It is convenient for presenting actions like “Delete” at the end of a boxed list.

AdwButtonRow is always activatable.

CSS nodes#

AdwButtonRow has a main CSS node with name row and the style class .button.

It contains the subnode box for its main horizontal box, which contains the nodes: image.icon.start for the start icon, label.title for the title, and image.icon.end for the end icon.

Style classes#

The `.suggested-action <style-classes.html#suggested-action>`__ style class makes AdwButtonRow use accent color for its background. It should be used very sparingly to denote important buttons.

https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/button-row-suggested-action.png

The `.destructive-action <style-classes.html#destructive-action>`__ style makes the row use destructive colors. It can be used to draw attention to the potentially damaging consequences of using it. This style acts as a warning to the user.

https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/button-row-destructive-action.png

Constructors#

class ButtonRow
classmethod new() Widget#

Creates a new AdwButtonRow.

Added in version 1.6.

Methods#

class ButtonRow
get_end_icon_name() str | None#

Gets the end icon name for self.

Added in version 1.6.

get_start_icon_name() str | None#

Gets the start icon name for self.

Added in version 1.6.

set_end_icon_name(icon_name: str | None = None) None#

Sets the end icon name for self.

Added in version 1.6.

Parameters:

icon_name – the end icon name

set_start_icon_name(icon_name: str | None = None) None#

Sets the start icon name for self.

Added in version 1.6.

Parameters:

icon_name – the start icon name

Properties#

class ButtonRow
props.end_icon_name: str#

The type of the None singleton.

Added in version 1.6.

props.start_icon_name: str#

The type of the None singleton.

Added in version 1.6.

Signals#

class ButtonRow.signals
activated() None#

The type of the None singleton.

Added in version 1.6.