StackProtocol

public protocol StackProtocol : ContainerProtocol

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 GtkStackSwitcher 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 gtk_stack_set_transition_type(). These animations respect the GtkSettings:gtk-enable-animations setting.

The GtkStack widget was added in GTK+ 3.10.

CSS nodes

GtkStack has a single CSS node named stack.

The StackProtocol protocol exposes the methods and properties of an underlying GtkStack instance. The default implementation of these can be found in the protocol extension below. For a concrete class that implements these methods and properties, see Stack. Alternatively, use StackRef as a lighweight, unowned reference if you already have an instance you just want to use.

Show on GitHub
  • ptr

    Untyped pointer to the underlying GtkStack instance.

    Declaration

    Swift

    var ptr: UnsafeMutableRawPointer! { get }
    Show on GitHub
  • stack_ptr Default implementation

    Typed pointer to the underlying GtkStack instance.

    Default Implementation

    Return the stored, untyped pointer as a typed pointer to the GtkStack instance.

    Declaration

    Swift

    var stack_ptr: UnsafeMutablePointer<GtkStack>! { get }
    Show on GitHub

  • Required Initialiser for types conforming to StackProtocol

    Declaration

    Swift

    init(raw: UnsafeMutableRawPointer)
    Show on GitHub

Stack Class

  • Bind a StackPropertyName source property to a given target object.

    Declaration

    Swift

    @discardableResult
@inlinable
func bind<Q, T>(property source_property: StackPropertyName, to target: T, _ target_property: Q, flags f: BindingFlags = .default, transformFrom transform_from: @escaping GLibObject.ValueTransformer = { $0.transform(destValue: $1) }, transformTo transform_to: @escaping GLibObject.ValueTransformer = { $0.transform(destValue: $1) }) -> BindingRef! where Q : PropertyNameProtocol, T : ObjectProtocol

    Parameters

    source_property

    the source property to bind
    target

    the target object to bind to
    target_property

    the target property to bind to
    flags

    the flags to pass to the Binding
    transform_from

    ValueTransformer to use for forward transformation
    transform_to

    ValueTransformer to use for backwards transformation

    Return Value

    binding reference or nil in case of an error

    Show on GitHub
  • get(property:) Extension method

    Get the value of a Stack property

    Declaration

    Swift

    @inlinable
func get(property: StackPropertyName) -> GLibObject.Value

    Parameters

    property

    the property to get the value for

    Return Value

    the value of the named property

    Show on GitHub
  • set(property:value:) Extension method

    Set the value of a Stack property. Note that this will only have an effect on properties that are writable and not construct-only!

    Declaration

    Swift

    @inlinable
func set(property: StackPropertyName, value v: GLibObject.Value)

    Parameters

    property

    the property to get the value for

    Return Value

    the value of the named property

    Show on GitHub

Stack Class: StackProtocol extension (methods and fields)

  • addNamed(child:name:) Extension method

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

    Declaration

    Swift

    @inlinable
func addNamed<WidgetT>(child: WidgetT, name: UnsafePointer<gchar>!) where WidgetT : WidgetProtocol
    Show on GitHub
  • addTitled(child:name:title:) Extension method

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

    Declaration

    Swift

    @inlinable
func addTitled<WidgetT>(child: WidgetT, name: UnsafePointer<gchar>!, title: UnsafePointer<gchar>!) where WidgetT : WidgetProtocol
    Show on GitHub
  • getChildBy(name:) Extension method

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

    Declaration

    Swift

    @inlinable
func getChildBy(name: UnsafePointer<gchar>!) -> WidgetRef!
    Show on GitHub
  • getHhomogeneous() Extension method

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

    Declaration

    Swift

    @inlinable
func getHhomogeneous() -> Bool
    Show on GitHub
  • getHomogeneous() Extension method

    Gets whether stack is homogeneous. See gtk_stack_set_homogeneous().

    Declaration

    Swift

    @inlinable
func getHomogeneous() -> Bool
    Show on GitHub
  • getInterpolateSize() Extension method

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

    Declaration

    Swift

    @inlinable
func getInterpolateSize() -> Bool
    Show on GitHub
  • getTransitionDuration() Extension method

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

    Declaration

    Swift

    @inlinable
func getTransitionDuration() -> Int
    Show on GitHub
  • getTransitionRunning() Extension method

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

    Declaration

    Swift

    @inlinable
func getTransitionRunning() -> Bool
    Show on GitHub
  • getTransitionType() Extension method

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

    Declaration

    Swift

    @inlinable
func getTransitionType() -> GtkStackTransitionType
    Show on GitHub
  • getVhomogeneous() Extension method

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

    Declaration

    Swift

    @inlinable
func getVhomogeneous() -> Bool
    Show on GitHub
  • getVisibleChild() Extension method

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

    Declaration

    Swift

    @inlinable
func getVisibleChild() -> WidgetRef!
    Show on GitHub
  • getVisibleChildName() Extension method

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

    Declaration

    Swift

    @inlinable
func getVisibleChildName() -> String!
    Show on GitHub
  • set(hhomogeneous:) Extension method

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

    Declaration

    Swift

    @inlinable
func set(hhomogeneous: Bool)
    Show on GitHub
  • set(homogeneous:) Extension method

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

    Declaration

    Swift

    @inlinable
func set(homogeneous: Bool)
    Show on GitHub
  • set(interpolateSize:) Extension method

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

    Declaration

    Swift

    @inlinable
func set(interpolateSize: Bool)
    Show on GitHub
  • setTransition(duration:) Extension method

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

    Declaration

    Swift

    @inlinable
func setTransition(duration: Int)
    Show on GitHub

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

    Declaration

    Swift

    @inlinable
func setTransitionType(transition: GtkStackTransitionType)
    Show on GitHub
  • set(vhomogeneous:) Extension method

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

    Declaration

    Swift

    @inlinable
func set(vhomogeneous: Bool)
    Show on GitHub
  • setVisible(child:) Extension method

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

    Declaration

    Swift

    @inlinable
func setVisible<WidgetT>(child: WidgetT) where WidgetT : WidgetProtocol
    Show on GitHub

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

    Declaration

    Swift

    @inlinable
func setVisibleChildFull(name: UnsafePointer<gchar>!, transition: GtkStackTransitionType)
    Show on GitHub
  • setVisibleChild(name:) Extension method

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

    Declaration

    Swift

    @inlinable
func setVisibleChild(name: UnsafePointer<gchar>!)
    Show on GitHub
  • hhomogeneous Extension method

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

    Declaration

    Swift

    @inlinable
var hhomogeneous: Bool { get nonmutating set }
    Show on GitHub
  • homogeneous Extension method

    Undocumented

    Declaration

    Swift

    @inlinable
var homogeneous: Bool { get nonmutating set }
    Show on GitHub
  • interpolateSize Extension method

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

    Declaration

    Swift

    @inlinable
var interpolateSize: Bool { get nonmutating set }
    Show on GitHub
  • transitionDuration Extension method

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

    Declaration

    Swift

    @inlinable
var transitionDuration: Int { get nonmutating set }
    Show on GitHub
  • transitionRunning Extension method

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

    Declaration

    Swift

    @inlinable
var transitionRunning: Bool { get }
    Show on GitHub
  • transitionType Extension method

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

    Declaration

    Swift

    @inlinable
var transitionType: GtkStackTransitionType { get nonmutating set }
    Show on GitHub
  • vhomogeneous Extension method

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

    Declaration

    Swift

    @inlinable
var vhomogeneous: Bool { get nonmutating set }
    Show on GitHub
  • visibleChild Extension method

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

    Declaration

    Swift

    @inlinable
var visibleChild: WidgetRef! { get nonmutating set }
    Show on GitHub
  • visibleChildName Extension method

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

    Declaration

    Swift

    @inlinable
var visibleChildName: String! { get nonmutating set }
    Show on GitHub
  • parentInstance Extension method

    Undocumented

    Declaration

    Swift

    @inlinable
var parentInstance: GtkContainer { get }
    Show on GitHub