:right-sidebar: True

ToolbarStyle
===================================================================

.. currentmodule:: gi.repository.Adw


.. versionadded:: 1.4




.. class:: ToolbarStyle
   :no-contents-entry:






Describes the possible top or bottom bar styles in an :obj:`~gi.repository.Adw.ToolbarView`
widget.

``ADW_TOOLBAR_FLAT`` is suitable for simple content, such as
:obj:`~gi.repository.Adw.StatusPage` or :obj:`~gi.repository.Adw.PreferencesPage`, where the background at the
top and bottom parts of the page is uniform. Additionally, windows with
sidebars should always use this style.

<picture style="min-width: 33%; display: inline-block;">
  <source srcset="toolbar-view-flat-1-dark.png" media="(prefers-color-scheme: dark)">
  <img src="toolbar-view-flat-1.png" alt="toolbar-view-flat-1">
<picture style="min-width: 33%; display: inline-block;">
  <source srcset="toolbar-view-flat-2-dark.png" media="(prefers-color-scheme: dark)">
  <img src="toolbar-view-flat-2.png" alt="toolbar-view-flat-2">

``ADW_TOOLBAR_RAISED`` style is suitable for content such as
`utility panes <https://developer.gnome.org/hig/patterns/containers/utility-panes.html>`_,
where some elements are directly adjacent to the top/bottom bars, or
:obj:`~gi.repository.Adw.TabView`, where each page can have a different background.

``ADW_TOOLBAR_RAISED_BORDER`` style is similar to ``ADW_TOOLBAR_RAISED``, but
with the shadow replaced with a more subtle border. It's intended to be used
in applications like image viewers, where a shadow over the content might be
undesired.

<picture style="min-width: 33%; display: inline-block;">
  <source srcset="toolbar-view-raised-dark.png" media="(prefers-color-scheme: dark)">
  <img src="toolbar-view-raised.png" alt="toolbar-view-raised">
<picture style="min-width: 33%; display: inline-block;">
  <source srcset="toolbar-view-raised-border-dark.png" media="(prefers-color-scheme: dark)">
  <img src="toolbar-view-raised-border.png" alt="toolbar-view-raised-border">

See :obj:`~gi.repository.Adw.ToolbarView.props.top_bar_style` and
:obj:`~gi.repository.Adw.ToolbarView.props.bottom_bar_style`.

New values may be added to this enumeration over time.













Fields
------

.. rst-class:: interim-class

.. class:: ToolbarStyle
   :no-index:
   

   .. attribute:: FLAT

      No background, shadow only for scrolled content







   .. attribute:: RAISED

      Opaque background with a persistent shadow







   .. attribute:: RAISED_BORDER

      Opaque background with a persistent border