Gtk.Stack¶

Example¶

Subclasses: None

Methods¶

Inherited: Gtk.Container (35), Gtk.Widget (278), GObject.Object (37), Gtk.Buildable (10)
Structs: Gtk.ContainerClass (5), Gtk.WidgetClass (12), GObject.ObjectClass (5)

class	`new` ()
	`add_named` (child, name)
	`add_titled` (child, name, title)
	`get_child_by_name` (name)
	`get_hhomogeneous` ()
	`get_homogeneous` ()
	`get_interpolate_size` ()
	`get_transition_duration` ()
	`get_transition_running` ()
	`get_transition_type` ()
	`get_vhomogeneous` ()
	`get_visible_child` ()
	`get_visible_child_name` ()
	`set_hhomogeneous` (hhomogeneous)
	`set_homogeneous` (homogeneous)
	`set_interpolate_size` (interpolate_size)
	`set_transition_duration` (duration)
	`set_transition_type` (transition)
	`set_vhomogeneous` (vhomogeneous)
	`set_visible_child` (child)
	`set_visible_child_full` (name, transition)
	`set_visible_child_name` (name)

Virtual Methods¶

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

Properties¶

Inherited: Gtk.Container (3), Gtk.Widget (39)

Name	Type	Flags	Short Description
`hhomogeneous`	`bool`	r/w/en	Horizontally homogeneous sizing
`homogeneous`	`bool`	r/w/en	Homogeneous sizing
`interpolate-size`	`bool`	r/w/en	Whether or not the size should smoothly change when changing between differently sized children
`transition-duration`	`int`	r/w/en	The animation duration, in milliseconds
`transition-running`	`bool`	r	Whether or not the transition is currently running
`transition-type`	`Gtk.StackTransitionType`	r/w/en	The type of animation used to transition
`vhomogeneous`	`bool`	r/w/en	Vertically homogeneous sizing
`visible-child`	`Gtk.Widget`	r/w/en	The widget currently visible in the stack
`visible-child-name`	`str`	r/w/en	The name of the widget currently visible in the stack

Child Properties¶

Name	Type	Default	Flags	Short Description
`icon-name`	`str`	`None`	r/w	The icon name of the child page
`name`	`str`	`None`	r/w	The name of the child page
`needs-attention`	`bool`	`False`	r/w	Whether this page needs attention
`position`	`int`	`0`	r/w	The index of the child in the parent
`title`	`str`	`None`	r/w	The title of the child page

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
parent_instance	`Gtk.Container`	r

Class Details¶

class Gtk.Stack(**kwargs)¶

Bases: Gtk.Container
Abstract: No
Structure: Gtk.StackClass

The Gtk.Stack widget is a container which only shows one of its children at a time. In contrast to Gtk.Notebook, Gtk.Stack does not provide a means for users to change the visible child. Instead, the Gtk.StackSwitcher widget can be used with Gtk.Stack to provide this functionality.

Transitions between pages can be animated as slides or fades. This can be controlled with Gtk.Stack.set_transition_type(). These animations respect the Gtk.Settings :gtk-enable-animations setting.

The Gtk.Stack widget was added in GTK+ 3.10.

CSS nodes

Gtk.Stack has a single CSS node named stack.

classmethod new()[source]¶

Returns: a new Gtk.Stack
Return type: Gtk.Widget

Creates a new Gtk.Stack container.

New in version 3.10.

add_named(child, name)[source]¶

Parameters

child (Gtk.Widget) – the widget to add
name (str) – the name for child

Adds a child to self. The child is identified by the name.

New in version 3.10.

add_titled(child, name, title)[source]¶

Parameters

child (Gtk.Widget) – the widget to add
name (str) – the name for child
title (str) – a human-readable title for child

Adds a child to self. The child is identified by the name. The title will be used by Gtk.StackSwitcher to represent child in a tab bar, so it should be short.

New in version 3.10.

get_child_by_name(name)[source]¶

Parameters: name (str) – the name of the child to find
Returns: the requested child of the Gtk.Stack
Return type: Gtk.Widget or None

Finds the child of the Gtk.Stack with the name given as the argument. Returns None if there is no child with this name.

New in version 3.12.

get_hhomogeneous()[source]¶

Returns: whether self is horizontally homogeneous.
Return type: bool

Gets whether self is horizontally homogeneous. See Gtk.Stack.set_hhomogeneous().

New in version 3.16.

get_homogeneous()[source]¶

Returns: whether self is homogeneous.
Return type: bool

Gets whether self is homogeneous. See Gtk.Stack.set_homogeneous().

New in version 3.10.

get_interpolate_size()[source]¶

Returns: True if child sizes are interpolated
Return type: bool

Returns wether the Gtk.Stack is set up to interpolate between the sizes of children on page switch.

New in version 3.18.

get_transition_duration()[source]¶

Returns: the transition duration
Return type: int

Returns the amount of time (in milliseconds) that transitions between pages in self will take.

New in version 3.10.

get_transition_running()[source]¶

Returns: True if the transition is currently running, False otherwise.
Return type: bool

Returns whether the self is currently in a transition from one page to another.

New in version 3.12.

get_transition_type()[source]¶

Returns: the current transition type of self
Return type: Gtk.StackTransitionType

Gets the type of animation that will be used for transitions between pages in self.

New in version 3.10.

get_vhomogeneous()[source]¶

Returns: whether self is vertically homogeneous.
Return type: bool

Gets whether self is vertically homogeneous. See Gtk.Stack.set_vhomogeneous().

New in version 3.16.

get_visible_child()[source]¶

Returns: the visible child of the Gtk.Stack
Return type: Gtk.Widget or None

Gets the currently visible child of self, or None if there are no visible children.

New in version 3.10.

get_visible_child_name()[source]¶

Returns: the name of the visible child of the Gtk.Stack
Return type: str or None

Returns the name of the currently visible child of self, or None if there is no visible child.

New in version 3.10.

set_hhomogeneous(hhomogeneous)[source]¶

Parameters: hhomogeneous (bool) – True to make self horizontally homogeneous

Sets the Gtk.Stack to be horizontally homogeneous or not. If it is homogeneous, the Gtk.Stack will request the same width for all its children. If it isn’t, the stack may change width when a different child becomes visible.

New in version 3.16.

set_homogeneous(homogeneous)[source]¶

Parameters: homogeneous (bool) – True to make self homogeneous

Sets the Gtk.Stack to be homogeneous or not. If it is homogeneous, the Gtk.Stack will request the same size for all its children. If it isn’t, the stack may change size when a different child becomes visible.

Since 3.16, homogeneity can be controlled separately for horizontal and vertical size, with the Gtk.Stack :hhomogeneous and Gtk.Stack :vhomogeneous.

New in version 3.10.

set_interpolate_size(interpolate_size)[source]¶

Parameters: interpolate_size (bool) – the new value

Sets whether or not self will interpolate its size when changing the visible child. If the Gtk.Stack :interpolate-size property is set to True, self will interpolate its size between the current one and the one it’ll take after changing the visible child, according to the set transition duration.

New in version 3.18.

set_transition_duration(duration)[source]¶

Parameters: duration (int) – the new duration, in milliseconds

Sets the duration that transitions between pages in self will take.

New in version 3.10.

set_transition_type(transition)[source]¶

Parameters: transition (Gtk.StackTransitionType) – the new transition type

Sets the type of animation that will be used for transitions between pages in self. Available types include various kinds of fades and slides.

The transition type can be changed without problems at runtime, so it is possible to change the animation based on the page that is about to become current.

New in version 3.10.

set_vhomogeneous(vhomogeneous)[source]¶

Parameters: vhomogeneous (bool) – True to make self vertically homogeneous

Sets the Gtk.Stack to be vertically homogeneous or not. If it is homogeneous, the Gtk.Stack will request the same height for all its children. If it isn’t, the stack may change height when a different child becomes visible.

New in version 3.16.

set_visible_child(child)[source]¶

Parameters: child (Gtk.Widget) – a child of self

Makes child the visible child of self.

If child is different from the currently visible child, the transition between the two will be animated with the current transition type of self.

Note that the child widget has to be visible itself (see Gtk.Widget.show()) in order to become the visible child of self.

New in version 3.10.

set_visible_child_full(name, transition)[source]¶

Parameters

name (str) – the name of the child to make visible
transition (Gtk.StackTransitionType) – the transition type to use

Makes the child with the given name visible.

Note that the child widget has to be visible itself (see Gtk.Widget.show()) in order to become the visible child of self.

New in version 3.10.

set_visible_child_name(name)[source]¶

Parameters: name (str) – the name of the child to make visible

Makes the child with the given name visible.

If child is different from the currently visible child, the transition between the two will be animated with the current transition type of self.

Note that the child widget has to be visible itself (see Gtk.Widget.show()) in order to become the visible child of self.

New in version 3.10.

Property Details¶

Gtk.Stack.props.hhomogeneous¶

Name: hhomogeneous
Type: bool
Default Value: True
Flags: READABLE, WRITABLE, EXPLICIT_NOTIFY

True if the stack allocates the same width for all children.

New in version 3.16.

Gtk.Stack.props.homogeneous¶

Name: homogeneous
Type: bool
Default Value: True
Flags: READABLE, WRITABLE, EXPLICIT_NOTIFY

Homogeneous sizing

Gtk.Stack.props.interpolate_size¶

Name: interpolate-size
Type: bool
Default Value: False
Flags: READABLE, WRITABLE, EXPLICIT_NOTIFY

Whether or not the size should smoothly change when changing between differently sized children

Gtk.Stack.props.transition_duration¶

Name: transition-duration
Type: int
Default Value: 200
Flags: READABLE, WRITABLE, EXPLICIT_NOTIFY

The animation duration, in milliseconds

Gtk.Stack.props.transition_running¶

Name: transition-running
Type: bool
Default Value: False
Flags: READABLE

Whether or not the transition is currently running

Gtk.Stack.props.transition_type¶

Name: transition-type
Type: Gtk.StackTransitionType
Default Value: Gtk.StackTransitionType.NONE
Flags: READABLE, WRITABLE, EXPLICIT_NOTIFY

The type of animation used to transition

Gtk.Stack.props.vhomogeneous¶

Name: vhomogeneous
Type: bool
Default Value: True
Flags: READABLE, WRITABLE, EXPLICIT_NOTIFY

True if the stack allocates the same height for all children.

New in version 3.16.

Gtk.Stack.props.visible_child¶

Name: visible-child
Type: Gtk.Widget
Default Value: None
Flags: READABLE, WRITABLE, EXPLICIT_NOTIFY

The widget currently visible in the stack

Gtk.Stack.props.visible_child_name¶

Name: visible-child-name
Type: str
Default Value: None
Flags: READABLE, WRITABLE, EXPLICIT_NOTIFY

The name of the widget currently visible in the stack