CSS nodes

CtkStack has a single CSS node named stack.

ctk_stack_new ()

CtkWidget *
ctk_stack_new (void);

Creates a new CtkStack container.

Since: 3.10

ctk_stack_add_named ()

void
ctk_stack_add_named (CtkStack *stack,
                     CtkWidget *child,
                     const gchar *name);

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

Since: 3.10

ctk_stack_add_titled ()

void
ctk_stack_add_titled (CtkStack *stack,
                      CtkWidget *child,
                      const gchar *name,
                      const gchar *title);

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

Since: 3.10

ctk_stack_get_child_by_name ()

CtkWidget *
ctk_stack_get_child_by_name (CtkStack *stack,
                             const gchar *name);

Finds the child of the CtkStack with the name given as the argument. Returns NULL if there is no child with this name.

Since: 3.12

ctk_stack_set_visible_child ()

void
ctk_stack_set_visible_child (CtkStack *stack,
                             CtkWidget *child);

Makes child the visible child of stack .

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

Note that the child widget has to be visible itself (see ctk_widget_show()) in order to become the visible child of stack .

Since: 3.10

ctk_stack_get_visible_child ()

CtkWidget *
ctk_stack_get_visible_child (CtkStack *stack);

Gets the currently visible child of stack , or NULL if there are no visible children.

Since: 3.10

ctk_stack_set_visible_child_name ()

void
ctk_stack_set_visible_child_name (CtkStack *stack,
                                  const gchar *name);

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 stack .

Note that the child widget has to be visible itself (see ctk_widget_show()) in order to become the visible child of stack .

Since: 3.10

ctk_stack_get_visible_child_name ()

const gchar *
ctk_stack_get_visible_child_name (CtkStack *stack);

Returns the name of the currently visible child of stack , or NULL if there is no visible child.

Since: 3.10

ctk_stack_set_visible_child_full ()

void
ctk_stack_set_visible_child_full (CtkStack *stack,
                                  const gchar *name,
                                  CtkStackTransitionType transition);

Makes the child with the given name visible.

Note that the child widget has to be visible itself (see ctk_widget_show()) in order to become the visible child of stack .

Since: 3.10

ctk_stack_set_homogeneous ()

void
ctk_stack_set_homogeneous (CtkStack *stack,
                           gboolean homogeneous);

Sets the CtkStack to be homogeneous or not. If it is homogeneous, the CtkStack 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 “hhomogeneous” and “vhomogeneous”.

Since: 3.10

ctk_stack_get_homogeneous ()

gboolean
ctk_stack_get_homogeneous (CtkStack *stack);

Gets whether stack is homogeneous. See ctk_stack_set_homogeneous().

Since: 3.10

ctk_stack_set_hhomogeneous ()

void
ctk_stack_set_hhomogeneous (CtkStack *stack,
                            gboolean hhomogeneous);

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

Since: 3.16

ctk_stack_get_hhomogeneous ()

gboolean
ctk_stack_get_hhomogeneous (CtkStack *stack);

Gets whether stack is horizontally homogeneous. See ctk_stack_set_hhomogeneous().

Since: 3.16

ctk_stack_set_vhomogeneous ()

void
ctk_stack_set_vhomogeneous (CtkStack *stack,
                            gboolean vhomogeneous);

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

Since: 3.16

ctk_stack_get_vhomogeneous ()

gboolean
ctk_stack_get_vhomogeneous (CtkStack *stack);

Gets whether stack is vertically homogeneous. See ctk_stack_set_vhomogeneous().

Since: 3.16

ctk_stack_set_transition_duration ()

void
ctk_stack_set_transition_duration (CtkStack *stack,
                                   guint duration);

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

Since: 3.10

ctk_stack_get_transition_duration ()

guint
ctk_stack_get_transition_duration (CtkStack *stack);

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

Since: 3.10

ctk_stack_set_transition_type ()

void
ctk_stack_set_transition_type (CtkStack *stack,
                               CtkStackTransitionType transition);

Sets the type of animation that will be used for transitions between pages in stack . 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.

Since: 3.10

ctk_stack_get_transition_type ()

CtkStackTransitionType
ctk_stack_get_transition_type (CtkStack *stack);

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

Since: 3.10

ctk_stack_get_transition_running ()

gboolean
ctk_stack_get_transition_running (CtkStack *stack);

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

Since: 3.12

ctk_stack_get_interpolate_size ()

gboolean
ctk_stack_get_interpolate_size (CtkStack *stack);

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

Since: 3.18

ctk_stack_set_interpolate_size ()

void
ctk_stack_set_interpolate_size (CtkStack *stack,
                                gboolean interpolate_size);

Sets whether or not stack will interpolate its size when changing the visible child. If the “interpolate-size” property is set to TRUE, stack 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.

Since: 3.18

struct CtkStack

struct CtkStack;

enum CtkStackTransitionType

These enumeration values describe the possible transitions between pages in a CtkStack widget.

New values may be added to this enumeration over time.

The “hhomogeneous” property

  “hhomogeneous”             gboolean

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

Owner: CtkStack

Flags: Read / Write

Default value: TRUE

Since: 3.16

The “homogeneous” property

  “homogeneous”              gboolean

Homogeneous sizing.

Owner: CtkStack

Flags: Read / Write

Default value: TRUE

The “interpolate-size” property

  “interpolate-size”         gboolean

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

Owner: CtkStack

Flags: Read / Write

Default value: FALSE

The “transition-duration” property

  “transition-duration”      guint

The animation duration, in milliseconds.

Owner: CtkStack

Flags: Read / Write

Default value: 200

The “transition-running” property

  “transition-running”       gboolean

Whether or not the transition is currently running.

Owner: CtkStack

Flags: Read

Default value: FALSE

The “transition-type” property

  “transition-type”          CtkStackTransitionType

The type of animation used to transition.

Owner: CtkStack

Flags: Read / Write

Default value: CTK_STACK_TRANSITION_TYPE_NONE

The “vhomogeneous” property

  “vhomogeneous”             gboolean

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

Owner: CtkStack

Flags: Read / Write

Default value: TRUE

Since: 3.16

The “visible-child” property

  “visible-child”            CtkWidget *

The widget currently visible in the stack.

Owner: CtkStack

Flags: Read / Write

The “visible-child-name” property

  “visible-child-name”       char *

The name of the widget currently visible in the stack.

Owner: CtkStack

Flags: Read / Write

Default value: NULL