StackSwitcher

class StackSwitcher(**properties: Any)

Superclasses: Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Buildable, ConstraintTarget, Orientable

The GtkStackSwitcher shows a row of buttons to switch between GtkStack pages.

It acts as a controller for the associated GtkStack.

All the content for the buttons comes from the properties of the stacks StackPage objects; the button visibility in a GtkStackSwitcher widget is controlled by the visibility of the child in the GtkStack.

It is possible to associate multiple GtkStackSwitcher widgets with the same GtkStack widget.

CSS nodes

GtkStackSwitcher has a single CSS node named stackswitcher and style class .stack-switcher.

When circumstances require it, GtkStackSwitcher adds the .needs-attention style class to the widgets representing the stack pages.

Accessibility

GtkStackSwitcher uses the TAB_LIST role and uses the TAB for its buttons.

Orientable

Since GTK 4.4, GtkStackSwitcher implements GtkOrientable allowing the stack switcher to be made vertical with :func:`~gi.repository.Gtk.Orientable.set_orientation`.

Constructors

class StackSwitcher

classmethod new() → Widget

Create a new GtkStackSwitcher.

Methods

class StackSwitcher

get_stack() → Stack | None

Retrieves the stack.

set_stack(stack: Stack | None = None) → None

Sets the stack to control.

Parameters:

stack – a GtkStack

Properties

class StackSwitcher

props.stack: Stack

The stack.