Struct gtk4::Stack

source · [−]

#[repr(transparent)]
pub struct Stack { /* private fields */ }

Expand description

Stack is a container which only shows one of its children at a time.

In contrast to Notebook, Stack does not provide a means for users to change the visible child. Instead, a separate widget such as StackSwitcher or StackSidebar can be used with Stack to provide this functionality.

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

Stack maintains a StackPage object for each added child, which holds additional per-child properties. You obtain the StackPage for a child with page() and you can obtain a SelectionModel containing all the pages with pages().

GtkStack as GtkBuildable

To set child-specific properties in a .ui file, create StackPage objects explicitly, and set the child widget as a property on it:

  <object class="GtkStack" id="stack">
    <child>
      <object class="GtkStackPage">
        <property name="name">page1</property>
        <property name="title">In the beginning…</property>
        <property name="child">
          <object class="GtkLabel">
            <property name="label">It was dark</property>
          </object>
        </property>
      </object>
    </child>

CSS nodes

Stack has a single CSS node named stack.

Accessibility

Stack uses the AccessibleRole::TabPanel for the stack pages, which are the accessible parent objects of the child widgets.

Implements

WidgetExt, glib::ObjectExt, AccessibleExt, BuildableExt, ConstraintTargetExt, WidgetExtManual, AccessibleExtManual

Struct gtk4::Stack

Implementations

impl Stack

pub fn new() -> Stack

pub fn builder() -> StackBuilder

pub fn add_child(&self, child: &impl IsA<Widget>) -> StackPage

pub fn add_named( &self, child: &impl IsA<Widget>, name: Option<&str>) -> StackPage

pub fn add_titled( &self, child: &impl IsA<Widget>, name: Option<&str>, title: &str) -> StackPage

pub fn child_by_name(&self, name: &str) -> Option<Widget>

pub fn is_hhomogeneous(&self) -> bool

pub fn interpolates_size(&self) -> bool

pub fn page(&self, child: &impl IsA<Widget>) -> StackPage

pub fn pages(&self) -> SelectionModel

pub fn transition_duration(&self) -> u32

pub fn is_transition_running(&self) -> bool

pub fn transition_type(&self) -> StackTransitionType

pub fn is_vhomogeneous(&self) -> bool

pub fn visible_child(&self) -> Option<Widget>

pub fn visible_child_name(&self) -> Option<GString>

pub fn remove(&self, child: &impl IsA<Widget>)

pub fn set_hhomogeneous(&self, hhomogeneous: bool)

pub fn set_interpolate_size(&self, interpolate_size: bool)

pub fn set_transition_duration(&self, duration: u32)

pub fn set_transition_type(&self, transition: StackTransitionType)

pub fn set_vhomogeneous(&self, vhomogeneous: bool)

pub fn set_visible_child(&self, child: &impl IsA<Widget>)

pub fn set_visible_child_full( &self, name: &str, transition: StackTransitionType)

pub fn set_visible_child_name(&self, name: &str)

pub fn connect_hhomogeneous_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_interpolate_size_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_pages_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_transition_duration_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_transition_running_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_transition_type_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_vhomogeneous_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_visible_child_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

pub fn connect_visible_child_name_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

Trait Implementations

impl Clone for Stack

fn clone(&self) -> Self

fn clone_from(&mut self, source: &Self)

impl Debug for Stack

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl Default for Stack

fn default() -> Self

impl Display for Stack

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl Hash for Stack

fn hash<H>(&self, state: &mut H) where H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H) where H: Hasher,

impl Ord for Stack

fn cmp(&self, other: &Self) -> Ordering

fn max(self, other: Self) -> Self

fn min(self, other: Self) -> Self

fn clamp(self, min: Self, max: Self) -> Self

impl ParentClassIs for Stack

type Parent = Widget

impl<OT: ObjectType> PartialEq<OT> for Stack

fn eq(&self, other: &OT) -> bool

fn ne(&self, other: &Rhs) -> bool

impl<OT: ObjectType> PartialOrd<OT> for Stack

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

fn lt(&self, other: &Rhs) -> bool

fn le(&self, other: &Rhs) -> bool

fn gt(&self, other: &Rhs) -> bool

fn ge(&self, other: &Rhs) -> bool

impl StaticType for Stack

fn static_type() -> Type

impl Eq for Stack

impl IsA<Accessible> for Stack

impl IsA<Buildable> for Stack

impl IsA<ConstraintTarget> for Stack

impl IsA<Widget> for Stack

Auto Trait Implementations

impl RefUnwindSafe for Stack

impl !Send for Stack

impl !Sync for Stack

impl Unpin for Stack

impl UnwindSafe for Stack

Blanket Implementations

pub fn add_named(
&self,
child: &impl IsA<Widget>,
name: Option<&str>
) -> StackPage

pub fn add_titled(
&self,
child: &impl IsA<Widget>,
name: Option<&str>,
title: &str
) -> StackPage

pub fn set_visible_child_full(
&self,
name: &str,
transition: StackTransitionType
)

pub fn connect_hhomogeneous_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_interpolate_size_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_pages_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_transition_duration_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_transition_running_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_transition_type_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_vhomogeneous_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_visible_child_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

pub fn connect_visible_child_name_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

fn hash<H>(&self, state: &mut H) where
H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,

impl<O> AccessibleExtManual for O where
O: IsA<Accessible>,

pub fn update_state(&Self, &[State ])

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T> Cast for T where
T: ObjectType,

fn upcast<T>(self) -> T where
T: ObjectType,
Self: IsA<T>,

fn upcast_ref<T>(&self) -> &T where
T: ObjectType,
Self: IsA<T>,

fn downcast<T>(self) -> Result<T, Self> where
T: ObjectType,
Self: CanDowncast<T>,

fn downcast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Self: CanDowncast<T>,

fn dynamic_cast<T>(self) -> Result<T, Self> where
T: ObjectType,

fn dynamic_cast_ref<T>(&self) -> Option<&T> where
T: ObjectType,

unsafe fn unsafe_cast<T>(self) -> T where
T: ObjectType,

unsafe fn unsafe_cast_ref<T>(&self) -> &T where
T: ObjectType,

impl<T, U> Into<U> for T where
U: From<T>,

impl<U> IsSubclassableExt for U where
U: IsClass + ParentClassIs,

pub fn parent_class_init<T>(class: &mut Class<U>) where
T: ObjectSubclass,
<U as ParentClassIs>::Parent: IsSubclassable<T>,

pub fn parent_instance_init<T>(instance: &mut InitializingObject<T>) where
T: ObjectSubclass,
<U as ParentClassIs>::Parent: IsSubclassable<T>,

impl<T> ObjectExt for T where
T: ObjectType,