Struct gtk4::Box

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

The Box widget arranges child widgets into a single row or column.

Whether it is a row or column depends on the value of its property::Orientable::orientation property. Within the other dimension, all children are allocated the same size. Of course, the property::Widget::halign and property::Widget::valign properties can be used on the children to influence their allocation.

Use repeated calls to BoxExt::append() to pack widgets into a Box from start to end. Use BoxExt::remove() to remove widgets from the Box. BoxExt::insert_child_after() can be used to add a child at a particular position.

Use BoxExt::set_homogeneous() to specify whether or not all children of the Box are forced to get the same amount of space.

Use BoxExt::set_spacing() to determine how much space will be minimally placed between all children in the Box. Note that spacing is added between the children.

Use BoxExt::reorder_child_after() to move a child to a different place in the box.

CSS nodes

Box uses a single CSS node with name box.

Accessibility

Box uses the AccessibleRole::Group role.

Implements

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

Implementations

impl Box

pub const NONE: Option<&'static Box> = None

pub fn new(orientation: Orientation, spacing: i32) -> Box

Creates a new Box.

orientation

the box’s orientation

spacing

the number of pixels to place by default between children

Returns

a new Box.

pub fn builder() -> BoxBuilder

Creates a new builder-pattern struct instance to construct Box objects.

This method returns an instance of BoxBuilder which can be used to create Box objects.

Trait Implementations

impl Clone for Box

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Box

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

Formats the value using the given formatter.

impl Default for Box

fn default() -> Self

Returns the “default value” for a type.

impl Display for Box

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

Formats the value using the given formatter.

impl Hash for Box

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<T: BoxImpl> IsSubclassable<T> for Box

fn class_init(class: &mut Class<Self>)

Override the virtual methods of this class for the given subclass and do other class initialization.

fn instance_init(instance: &mut InitializingObject<T>)

Instance specific initialization.

impl Ord for Box

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for Box

type Parent = Widget

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

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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

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

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Box

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for Box

impl IsA<Accessible> for Box

impl IsA<Box> for ShortcutsGroup

impl IsA<Box> for ShortcutsSection

impl IsA<Buildable> for Box

impl IsA<ConstraintTarget> for Box

impl IsA<Orientable> for Box

impl IsA<Widget> for Box