:right-sidebar: True

ButtonRow
===================================================================

.. currentmodule:: gi.repository.Adw


.. versionadded:: 1.6




.. class:: ButtonRow(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Adw.PreferencesRow`, :class:`~gi.repository.Gtk.ListBoxRow`, :class:`~gi.repository.Gtk.Widget`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Gtk.Accessible`, :class:`~gi.repository.Gtk.Actionable`, :class:`~gi.repository.Gtk.Buildable`, :class:`~gi.repository.Gtk.ConstraintTarget`



A :obj:`~gi.repository.Gtk.ListBoxRow` that looks like a button.

.. image:: 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.

.. image:: 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.

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


Constructors
------------

.. rst-class:: interim-class

.. class:: ButtonRow
   :no-index:


   .. classmethod:: new() -> ~gi.repository.Gtk.Widget

      Creates a new ``AdwButtonRow``\.


      .. versionadded:: 1.6












Methods
-------

.. rst-class:: interim-class

.. class:: ButtonRow
   :no-index:


   .. method:: get_end_icon_name() -> str | None

      Gets the end icon name for ``self``\.


      .. versionadded:: 1.6








   .. method:: get_start_icon_name() -> str | None

      Gets the start icon name for ``self``\.


      .. versionadded:: 1.6








   .. method:: set_end_icon_name(icon_name: str | None = None) -> None

      Sets the end icon name for ``self``\.


      .. versionadded:: 1.6





      :param icon_name: the end icon name




   .. method:: set_start_icon_name(icon_name: str | None = None) -> None

      Sets the start icon name for ``self``\.


      .. versionadded:: 1.6





      :param icon_name: the start icon name








Properties
----------

.. rst-class:: interim-class

.. class:: ButtonRow
   :no-index:
   

   .. attribute:: props.end_icon_name
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.6





   .. attribute:: props.start_icon_name
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.6









Signals
-------

.. rst-class:: interim-class

.. class:: ButtonRow.signals
   :no-index:
   

   .. method:: activated() -> None

      The type of the None singleton.



      .. versionadded:: 1.6