GI.Gtk.Objects.Stack

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

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

GtkStack maintains a StackPage object for each added child, which holds additional per-child properties. You obtain the StackPage for a child with stackGetPage.

GtkStack as GtkBuildable

To set child-specific properties in a .ui file, create GtkStackPage objects explicitly, and set the child widget as a property on it: > > class="GtkStack" id="stack" > child > class="GtkStackPage" > name="name"page1/property > name="title"In the beginning…/property > name="child" > class="GtkLabel" > name="label"It was dark/property > /object > /property > /object > /child

CSS nodes

GtkStack has a single CSS node named stack.

Accessibility

GtkStack uses the GTK_ACCESSIBLE_ROLE_TAB_PANEL for the stack pages, which are the accessible parent objects of the child widgets.

Exported types

newtype Stack

Memory-managed wrapper type.

Constructors

Stack (ManagedPtr Stack)

Instances

Eq Stack

Defined in GI.Gtk.Objects.Stack

Methods

(==) :: Stack -> Stack -> Bool

(/=) :: Stack -> Stack -> Bool

GObject Stack

Defined in GI.Gtk.Objects.Stack

ManagedPtrNewtype Stack

Defined in GI.Gtk.Objects.Stack

Methods

toManagedPtr :: Stack -> ManagedPtr Stack

TypedObject Stack

Defined in GI.Gtk.Objects.Stack

Methods

glibType :: IO GType

HasParentTypes Stack

Defined in GI.Gtk.Objects.Stack

IsGValue (Maybe Stack)

Convert Stack to and from GValue. See toGValue and fromGValue.

Defined in GI.Gtk.Objects.Stack

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe Stack -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe Stack)

type ParentTypes Stack

Defined in GI.Gtk.Objects.Stack

type ParentTypes Stack = '[Widget, Object, Accessible, Buildable, ConstraintTarget]

class (GObject o, IsDescendantOf Stack o) => IsStack o

Type class for types which can be safely cast to Stack, for instance with toStack.

Instances

(GObject o, IsDescendantOf Stack o) => IsStack o

Defined in GI.Gtk.Objects.Stack

toStack :: (MonadIO m, IsStack o) => o -> m Stack

Cast to Stack, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

actionSetEnabled, activate, activateAction, activateDefault, addChild, addController, addCssClass, addMnemonicLabel, addNamed, addTickCallback, addTitled, allocate, bindProperty, bindPropertyFull, childFocus, computeBounds, computeExpand, computePoint, computeTransform, contains, createPangoContext, createPangoLayout, dragCheckThreshold, errorBell, forceFloating, freezeNotify, getv, grabFocus, hasCssClass, hasDefault, hasFocus, hasVisibleFocus, hide, inDestruction, initTemplate, insertActionGroup, insertAfter, insertBefore, isAncestor, isDrawable, isFloating, isFocus, isSensitive, isVisible, keynavFailed, listMnemonicLabels, map, measure, mnemonicActivate, notify, notifyByPspec, observeChildren, observeControllers, pick, queueAllocate, queueDraw, queueResize, realize, ref, refSink, remove, removeController, removeCssClass, removeMnemonicLabel, removeTickCallback, resetProperty, resetRelation, resetState, runDispose, shouldLayout, show, sizeAllocate, snapshotChild, stealData, stealQdata, thawNotify, translateCoordinates, triggerTooltipQuery, unmap, unparent, unrealize, unref, unsetStateFlags, updateProperty, updateRelation, updateState, watchClosure.

Getters

getAccessibleRole, getAllocatedBaseline, getAllocatedHeight, getAllocatedWidth, getAllocation, getAncestor, getBuildableId, getCanFocus, getCanTarget, getChildByName, getChildVisible, getClipboard, getCssClasses, getCssName, getCursor, getData, getDirection, getDisplay, getFirstChild, getFocusChild, getFocusOnClick, getFocusable, getFontMap, getFontOptions, getFrameClock, getHalign, getHasTooltip, getHeight, getHexpand, getHexpandSet, getHhomogeneous, getInterpolateSize, getLastChild, getLayoutManager, getMapped, getMarginBottom, getMarginEnd, getMarginStart, getMarginTop, getName, getNative, getNextSibling, getOpacity, getOverflow, getPage, getPages, getPangoContext, getParent, getPreferredSize, getPrevSibling, getPrimaryClipboard, getProperty, getQdata, getRealized, getReceivesDefault, getRequestMode, getRoot, getScaleFactor, getSensitive, getSettings, getSize, getSizeRequest, getStateFlags, getStyleContext, getTemplateChild, getTooltipMarkup, getTooltipText, getTransitionDuration, getTransitionRunning, getTransitionType, getValign, getVexpand, getVexpandSet, getVhomogeneous, getVisible, getVisibleChild, getVisibleChildName, getWidth.

Setters

setCanFocus, setCanTarget, setChildVisible, setCssClasses, setCursor, setCursorFromName, setData, setDataFull, setDirection, setFocusChild, setFocusOnClick, setFocusable, setFontMap, setFontOptions, setHalign, setHasTooltip, setHexpand, setHexpandSet, setHhomogeneous, setInterpolateSize, setLayoutManager, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setName, setOpacity, setOverflow, setParent, setProperty, setReceivesDefault, setSensitive, setSizeRequest, setStateFlags, setTooltipMarkup, setTooltipText, setTransitionDuration, setTransitionType, setValign, setVexpand, setVexpandSet, setVhomogeneous, setVisible, setVisibleChild, setVisibleChildFull, setVisibleChildName.

addChild

stackAddChild

Arguments

:: (HasCallStack, MonadIO m, IsStack a, IsWidget b)

=> a

stack: a Stack

-> b

child: the widget to add

-> m StackPage

Returns: the StackPage for child

Adds a child to stack.

addNamed

stackAddNamed

Arguments

:: (HasCallStack, MonadIO m, IsStack a, IsWidget b)

=> a

stack: a Stack

-> b

child: the widget to add

-> Maybe Text

name: the name for child or Nothing

-> m StackPage

Returns: the StackPage for child

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

addTitled

stackAddTitled

Arguments

:: (HasCallStack, MonadIO m, IsStack a, IsWidget b)

=> a

stack: a Stack

-> b

child: the widget to add

-> Maybe Text

name: the name for child

-> Text

title: a human-readable title for child

-> m StackPage

Returns: the StackPage for child

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

getChildByName

stackGetChildByName

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> Text

name: the name of the child to find

-> m (Maybe Widget)

Returns: the requested child of the Stack

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

getHhomogeneous

stackGetHhomogeneous

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> m Bool

Returns: whether stack is horizontally homogeneous.

Gets whether stack is horizontally homogeneous. See stackSetHhomogeneous.

getInterpolateSize

stackGetInterpolateSize

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: A Stack

-> m Bool

Returns: True if child sizes are interpolated

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

getPage

stackGetPage

Arguments

:: (HasCallStack, MonadIO m, IsStack a, IsWidget b)

=> a

stack: a Stack

-> b

child: a child of stack

-> m StackPage

Returns: the StackPage for child

Returns the StackPage object for child.

getPages

stackGetPages

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> m SelectionModel

Returns: a SelectionModel for the stack's children

Returns a ListModel that contains the pages of the stack, and can be used to keep an up-to-date view. The model also implements SelectionModel and can be used to track and modify the visible page.

getTransitionDuration

stackGetTransitionDuration

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> m Word32

Returns: the transition duration

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

getTransitionRunning

stackGetTransitionRunning

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> m Bool

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

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

getTransitionType

stackGetTransitionType

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> m StackTransitionType

Returns: the current transition type of stack

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

getVhomogeneous

stackGetVhomogeneous

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> m Bool

Returns: whether stack is vertically homogeneous.

Gets whether stack is vertically homogeneous. See stackSetVhomogeneous.

getVisibleChild

stackGetVisibleChild

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> m (Maybe Widget)

Returns: the visible child of the Stack

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

getVisibleChildName

stackGetVisibleChildName

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> m (Maybe Text)

Returns: the name of the visible child of the Stack

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

new

stackNew

Arguments

:: (HasCallStack, MonadIO m)

=> m Stack

Returns: a new Stack

Creates a new Stack container.

remove

stackRemove

Arguments

:: (HasCallStack, MonadIO m, IsStack a, IsWidget b)

=> a

stack: a Stack

-> b

child: the child to remove

-> m ()

Removes a child widget from stack.

setHhomogeneous

stackSetHhomogeneous

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> Bool

hhomogeneous: True to make stack horizontally homogeneous

-> m ()

Sets the Stack to be horizontally homogeneous or not. If it is homogeneous, the 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.

setInterpolateSize

stackSetInterpolateSize

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: A Stack

-> Bool

interpolateSize: the new value

-> m ()

Sets whether or not stack will interpolate its size when changing the visible child. If the Stack: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.

setTransitionDuration

stackSetTransitionDuration

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> Word32

duration: the new duration, in milliseconds

-> m ()

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

setTransitionType

stackSetTransitionType

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> StackTransitionType

transition: the new transition type

-> m ()

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.

setVhomogeneous

stackSetVhomogeneous

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> Bool

vhomogeneous: True to make stack vertically homogeneous

-> m ()

Sets the Stack to be vertically homogeneous or not. If it is homogeneous, the 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.

setVisibleChild

stackSetVisibleChild

Arguments

:: (HasCallStack, MonadIO m, IsStack a, IsWidget b)

=> a

stack: a Stack

-> b

child: a child of stack

-> m ()

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 widgetShow) in order to become the visible child of stack.

setVisibleChildFull

stackSetVisibleChildFull

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> Text

name: the name of the child to make visible

-> StackTransitionType

transition: the transition type to use

-> m ()

Makes the child with the given name visible.

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

setVisibleChildName

stackSetVisibleChildName

Arguments

:: (HasCallStack, MonadIO m, IsStack a)

=> a

stack: a Stack

-> Text

name: the name of the child to make visible

-> m ()

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 widgetShow) in order to become the visible child of stack.

Properties

hhomogeneous

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

constructStackHhomogeneous :: (IsStack o, MonadIO m) => Bool -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “hhomogeneous” property. This is rarely needed directly, but it is used by new.

getStackHhomogeneous :: (MonadIO m, IsStack o) => o -> m Bool

Get the value of the “hhomogeneous” property. When overloading is enabled, this is equivalent to

get stack #hhomogeneous

setStackHhomogeneous :: (MonadIO m, IsStack o) => o -> Bool -> m ()

Set the value of the “hhomogeneous” property. When overloading is enabled, this is equivalent to

set stack [ #hhomogeneous := value ]

interpolateSize

No description available in the introspection data.

constructStackInterpolateSize :: (IsStack o, MonadIO m) => Bool -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “interpolate-size” property. This is rarely needed directly, but it is used by new.

getStackInterpolateSize :: (MonadIO m, IsStack o) => o -> m Bool

Get the value of the “interpolate-size” property. When overloading is enabled, this is equivalent to

get stack #interpolateSize

setStackInterpolateSize :: (MonadIO m, IsStack o) => o -> Bool -> m ()

Set the value of the “interpolate-size” property. When overloading is enabled, this is equivalent to

set stack [ #interpolateSize := value ]

pages

No description available in the introspection data.

getStackPages :: (MonadIO m, IsStack o) => o -> m (Maybe SelectionModel)

Get the value of the “pages” property. When overloading is enabled, this is equivalent to

get stack #pages

transitionDuration

No description available in the introspection data.

constructStackTransitionDuration :: (IsStack o, MonadIO m) => Word32 -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “transition-duration” property. This is rarely needed directly, but it is used by new.

getStackTransitionDuration :: (MonadIO m, IsStack o) => o -> m Word32

Get the value of the “transition-duration” property. When overloading is enabled, this is equivalent to

get stack #transitionDuration

setStackTransitionDuration :: (MonadIO m, IsStack o) => o -> Word32 -> m ()

Set the value of the “transition-duration” property. When overloading is enabled, this is equivalent to

set stack [ #transitionDuration := value ]

transitionRunning

No description available in the introspection data.

getStackTransitionRunning :: (MonadIO m, IsStack o) => o -> m Bool

Get the value of the “transition-running” property. When overloading is enabled, this is equivalent to

get stack #transitionRunning

transitionType

No description available in the introspection data.

constructStackTransitionType :: (IsStack o, MonadIO m) => StackTransitionType -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “transition-type” property. This is rarely needed directly, but it is used by new.

getStackTransitionType :: (MonadIO m, IsStack o) => o -> m StackTransitionType

Get the value of the “transition-type” property. When overloading is enabled, this is equivalent to

get stack #transitionType

setStackTransitionType :: (MonadIO m, IsStack o) => o -> StackTransitionType -> m ()

Set the value of the “transition-type” property. When overloading is enabled, this is equivalent to

set stack [ #transitionType := value ]

vhomogeneous

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

constructStackVhomogeneous :: (IsStack o, MonadIO m) => Bool -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “vhomogeneous” property. This is rarely needed directly, but it is used by new.

getStackVhomogeneous :: (MonadIO m, IsStack o) => o -> m Bool

Get the value of the “vhomogeneous” property. When overloading is enabled, this is equivalent to

get stack #vhomogeneous

setStackVhomogeneous :: (MonadIO m, IsStack o) => o -> Bool -> m ()

Set the value of the “vhomogeneous” property. When overloading is enabled, this is equivalent to

set stack [ #vhomogeneous := value ]

visibleChild

No description available in the introspection data.

constructStackVisibleChild :: (IsStack o, MonadIO m, IsWidget a) => a -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “visible-child” property. This is rarely needed directly, but it is used by new.

getStackVisibleChild :: (MonadIO m, IsStack o) => o -> m (Maybe Widget)

Get the value of the “visible-child” property. When overloading is enabled, this is equivalent to

get stack #visibleChild

setStackVisibleChild :: (MonadIO m, IsStack o, IsWidget a) => o -> a -> m ()

Set the value of the “visible-child” property. When overloading is enabled, this is equivalent to

set stack [ #visibleChild := value ]

visibleChildName

No description available in the introspection data.

constructStackVisibleChildName :: (IsStack o, MonadIO m) => Text -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “visible-child-name” property. This is rarely needed directly, but it is used by new.

getStackVisibleChildName :: (MonadIO m, IsStack o) => o -> m (Maybe Text)

Get the value of the “visible-child-name” property. When overloading is enabled, this is equivalent to

get stack #visibleChildName

setStackVisibleChildName :: (MonadIO m, IsStack o) => o -> Text -> m ()

Set the value of the “visible-child-name” property. When overloading is enabled, this is equivalent to

set stack [ #visibleChildName := value ]