Gtk.StackSwitcher

Example

Subclasses:

None

Methods

Inherited:

Gtk.Box (14), Gtk.Container (35), Gtk.Widget (278), GObject.Object (37), Gtk.Buildable (10), Gtk.Orientable (2)

Structs:

Gtk.ContainerClass (5), Gtk.WidgetClass (12), GObject.ObjectClass (5)

class	new ()
	get_stack ()
	set_stack (stack)

Virtual Methods

Inherited:

Gtk.Container (10), Gtk.Widget (82), GObject.Object (7), Gtk.Buildable (10)

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)

Signals

Inherited:

Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

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()

Returns:

a new Gtk.StackSwitcher.

Return type:

Gtk.Widget

Create a new Gtk.StackSwitcher.

New in version 3.10.

get_stack()

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)

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