:right-sidebar: True

ActionBar
===================================================================

.. currentmodule:: gi.repository.Gtk





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


Superclasses: :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.Buildable`, :class:`~gi.repository.Gtk.ConstraintTarget`



``GtkActionBar`` is designed to present contextual actions.


.. image:: https://docs.gtk.org/gtk4/action-bar.png


It is expected to be displayed below the content and expand
horizontally to fill the area.

It allows placing children at the start or the end. In addition, it
contains an internal centered box which is centered with respect to
the full width of the box, even if the children at either side take
up different amounts of space.

GtkActionBar as GtkBuildable
----------------------------

The ``GtkActionBar`` implementation of the ``GtkBuildable`` interface supports
adding children at the start or end sides by specifying “start” or “end” as
the “type” attribute of a ``<child>`` element, or setting the center widget
by specifying “center” value.

CSS nodes
---------


.. code-block::
   :dedent:

   actionbar
   ╰── revealer
       ╰── box
           ├── box.start
           │   ╰── [start children]
           ├── [center widget]
           ╰── box.end
               ╰── [end children]


A ``GtkActionBar``'s CSS node is called ``actionbar``. It contains a ``revealer``
subnode, which contains a ``box`` subnode, which contains two ``box`` subnodes at
the start and end of the action bar, with ``start`` and `end style classes
respectively, as well as a center node that represents the center child.

Each of the boxes contains children packed for that side.



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

.. rst-class:: interim-class

.. class:: ActionBar
   :no-index:


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

      Creates a new ``GtkActionBar`` widget.














Methods
-------

.. rst-class:: interim-class

.. class:: ActionBar
   :no-index:


   .. method:: get_center_widget() -> ~gi.repository.Gtk.Widget | None

      Retrieves the center bar widget of the bar.










   .. method:: get_revealed() -> bool

      Gets whether the contents of the action bar are revealed.










   .. method:: pack_end(child: ~gi.repository.Gtk.Widget) -> None

      Adds ``child`` to ``action_bar``, packed with reference to the
      end of the ``action_bar``.







      :param child: the ``GtkWidget`` to be added to ``action_bar``





   .. method:: pack_start(child: ~gi.repository.Gtk.Widget) -> None

      Adds ``child`` to ``action_bar``, packed with reference to the
      start of the ``action_bar``.







      :param child: the ``GtkWidget`` to be added to ``action_bar``





   .. method:: remove(child: ~gi.repository.Gtk.Widget) -> None

      Removes a child from ``action_bar``.







      :param child: the ``GtkWidget`` to be removed





   .. method:: set_center_widget(center_widget: ~gi.repository.Gtk.Widget | None = None) -> None

      Sets the center widget for the ``GtkActionBar``.







      :param center_widget: a widget to use for the center





   .. method:: set_revealed(revealed: bool) -> None

      Reveals or conceals the content of the action bar.

      Note: this does not show or hide ``action_bar`` in the
      :obj:`~gi.repository.Gtk.Widget.props.visible` sense, so revealing has
      no effect if the action bar is hidden.







      :param revealed: The new value of the property









Properties
----------

.. rst-class:: interim-class

.. class:: ActionBar
   :no-index:
   

   .. attribute:: props.revealed
      :type: bool

      Controls whether the action bar shows its contents.