Class
AdwViewSwitcher
Description [src]
final class Adw.ViewSwitcher : Gtk.Widget {
/* No available fields */
}
An adaptive view switcher.
An adaptive view switcher designed to switch between multiple views
contained in a AdwViewStack
in a similar fashion to
GtkStackSwitcher
.
AdwViewSwitcher
buttons always have an icon and a label. They can be
displayed side by side, or icon on top of the label. This can be controlled
via the AdwViewSwitcher:policy
property.
AdwViewSwitcher
is intended to be used in a header bar together with
AdwViewSwitcherBar
at the bottom of the window, 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
AdwViewSwitcher
has a single CSS node with name viewswitcher
. It can have
the style classes .wide
and .narrow
, matching its policy.
Accessibility
AdwViewSwitcher
uses the GTK_ACCESSIBLE_ROLE_TAB_LIST
role and uses the
GTK_ACCESSIBLE_ROLE_TAB
for its buttons.
Constructors
adw_view_switcher_new
Creates a new AdwViewSwitcher
.
Instance methods
adw_view_switcher_get_policy
Gets the policy of self
.
adw_view_switcher_get_stack
Gets the stack controlled by self
.
adw_view_switcher_set_policy
Sets the policy of self
.
adw_view_switcher_set_stack
Sets the stack controlled by self
.
Properties
Adw.ViewSwitcher:policy
The policy to determine which mode to use.
Adw.ViewSwitcher:stack
The stack the view switcher controls.