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

:obj:`~gi.repository.Adw.ToolbarStyle.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>
<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">
</picture>

:obj:`~gi.repository.Adw.ToolbarStyle.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.

:obj:`~gi.repository.Adw.ToolbarStyle.raised-border` style is similar to
:obj:`~gi.repository.Adw.ToolbarStyle.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>
<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">
</picture>

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