Gtk.StackSwitcher

g Atk.ImplementorIface Atk.ImplementorIface Gtk.Widget Gtk.Widget Atk.ImplementorIface->Gtk.Widget GObject.GInterface GObject.GInterface GObject.GInterface->Atk.ImplementorIface Gtk.Buildable Gtk.Buildable GObject.GInterface->Gtk.Buildable Gtk.Orientable Gtk.Orientable GObject.GInterface->Gtk.Orientable GObject.InitiallyUnowned GObject.InitiallyUnowned GObject.InitiallyUnowned->Gtk.Widget GObject.Object GObject.Object GObject.Object->GObject.InitiallyUnowned Gtk.Box Gtk.Box Gtk.StackSwitcher Gtk.StackSwitcher Gtk.Box->Gtk.StackSwitcher Gtk.Buildable->Gtk.Widget Gtk.Container Gtk.Container Gtk.Container->Gtk.Box Gtk.Orientable->Gtk.Box Gtk.Widget->Gtk.Container

Example

../_images/StackSwitcher.png
Subclasses:None

Properties

Inherited:Gtk.Box (3), Gtk.Container (3), Gtk.Widget (39), Gtk.Orientable (1)
Name Type Flags Short Description
icon-size int r/w/en Symbolic size to use for named icon
stack Gtk.Stack r/w/c Stack

Child Properties

Inherited:Gtk.Box (5)

Style Properties

Inherited:Gtk.Widget (17)

Fields

Inherited:Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)
Name Type Access Description
widget Gtk.Box r  

Class Details

class Gtk.StackSwitcher(*args, **kwargs)
Bases:Gtk.Box
Abstract:No
Structure:Gtk.StackSwitcherClass

The Gtk.StackSwitcher widget acts as a controller for a Gtk.Stack; it shows a row of buttons to switch between the various pages of the associated stack widget.

All the content for the buttons comes from the child properties of the Gtk.Stack; the button visibility in a Gtk.StackSwitcher widget is controlled by the visibility of the child in the Gtk.Stack.

It is possible to associate multiple Gtk.StackSwitcher widgets with the same Gtk.Stack widget.

The Gtk.StackSwitcher widget was added in 3.10.

CSS nodes

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

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

classmethod new()[source]
Returns:a new Gtk.StackSwitcher.
Return type:Gtk.Widget

Create a new Gtk.StackSwitcher.

New in version 3.10.

get_stack()[source]
Returns:the stack, or None if none has been set explicitly.
Return type:Gtk.Stack or None

Retrieves the stack. See Gtk.StackSwitcher.set_stack().

New in version 3.10.

set_stack(stack)[source]
Parameters:stack (Gtk.Stack or None) – a Gtk.Stack

Sets the stack to control.

New in version 3.10.

Property Details

Gtk.StackSwitcher.props.icon_size
Name:icon-size
Type:int
Default Value:1
Flags:READABLE, WRITABLE, EXPLICIT_NOTIFY

Use the “icon-size” property to change the size of the image displayed when a Gtk.StackSwitcher is displaying icons.

New in version 3.20.

Gtk.StackSwitcher.props.stack
Name:stack
Type:Gtk.Stack
Default Value:None
Flags:READABLE, WRITABLE, CONSTRUCT

Stack