Class

AdwViewSwitcherBar

Description [src]

final class Adw.ViewSwitcherBar : Gtk.Widget {
  /* No available fields */
}

A view switcher action bar.

view-switcher-bar

An action bar letting you switch between multiple views contained in a AdwViewStack, via an AdwViewSwitcher. It is designed to be put at the bottom of a window and to be revealed only on really narrow windows, e.g. on mobile phones. It can’t be revealed if there are less than two pages.

AdwViewSwitcherBar is intended to be used together with AdwViewSwitcher in a header bar, and a AdwBreakpoint showing the view switcher bar on narrow sizes, while removing the view switcher from the header bar, as follows:

<object class="AdwWindow">
  <property name="width-request">360</property>
  <property name="height-request">200</property>
  <child>
    <object class="AdwBreakpoint">
      <condition>max-width: 550sp</condition>
      <setter object="switcher_bar" property="reveal">True</setter>
      <setter object="header_bar" property="title-widget"/>
    </object>
  </child>
  <property name="content">
    <object class="AdwToolbarView">
      <child type="top">
        <object class="AdwHeaderBar" id="header_bar">
          <property name="title-widget">
            <object class="AdwViewSwitcher">
              <property name="stack">stack</property>
              <property name="policy">wide</property>
            </object>
          </property>
        </object>
      </child>
      <property name="content">
        <object class="AdwViewStack" id="stack"/>
      </property>
      <child type="bottom">
        <object class="AdwViewSwitcherBar" id="switcher_bar">
          <property name="stack">stack</property>
        </object>
      </child>
    </object>
  </property>
</object>

It’s recommended to set AdwViewSwitcher:policy to ADW_VIEW_SWITCHER_POLICY_WIDE in this case.

You may have to adjust the breakpoint condition for your specific pages.

CSS nodes

AdwViewSwitcherBar has a single CSS node with nameviewswitcherbar.

Ancestors

  • GtkWidget
  • GInitiallyUnowned
  • GObject

Implements

  • GtkAccessible
  • GtkBuildable
  • GtkConstraintTarget

Constructors

adw_view_switcher_bar_new

Creates a new AdwViewSwitcherBar.

Instance methods

adw_view_switcher_bar_get_reveal

Gets whether self should be revealed or hidden.

adw_view_switcher_bar_get_stack

Gets the stack controlled by self.

adw_view_switcher_bar_set_reveal

Sets whether self should be revealed or hidden.

adw_view_switcher_bar_set_stack

Sets the stack controlled by self.

Properties

Adw.ViewSwitcherBar:reveal

Whether the bar should be revealed or hidden.

Adw.ViewSwitcherBar:stack

The stack the view switcher controls.

Class structure

struct AdwViewSwitcherBarClass {
  GtkWidgetClass parent_class;
  
}
Class members
parent_class
GtkWidgetClass
  No description available.