Struct Container

pub struct Container<S: State> { /* private fields */ }

A container widget that can display and layout multiple child widgets.

The layout of the children (row, column, etc.) depends on the LayoutStyle of the container.

See the counter example for how to use it in practice.

Theming

The container widget doesn’t actually draw anything but the child widgets, so theming is useless.

Implementations

impl<S: State> Container<S>

pub fn new(children: Vec<Val<S, Box<dyn Widget<S>>>>) -> Self

Creates a new container with given children.

pub fn add_children(&mut self, children: Vec<Val<S, Box<dyn Widget<S>>>>)

Adds the given children to the container.

pub fn with_children(self, children: Vec<Val<S, Box<dyn Widget<S>>>>) -> Self

Adds the given children to the container and returns itself.

pub fn add_child(&mut self, child: impl Into<Val<S, Box<dyn Widget<S>>>>)

Adds the given child to the container.

pub fn with_child(self, child: impl Into<Val<S, Box<dyn Widget<S>>>>) -> Self

Adds the given child to the container and returns itself.

Trait Implementations

impl<S: State> Default for Container<S>

fn default() -> Self

Returns the “default value” for a type.

impl<S: State> Widget<S> for Container<S>

fn render( &mut self, scene: &mut Scene, theme: &mut dyn Theme, info: &AppInfo, layout_node: &LayoutNode, state: &S, )

Render the widget to the canvas.

fn layout_style(&mut self, state: &S) -> StyleNode

Return the layout style node for layout computation.

fn update( &mut self, layout: &LayoutNode, state: &mut S, info: &AppInfo, ) -> Update

Update the widget state with given info and layout. Returns if the app should be updated.

fn widget_id(&self) -> WidgetId

Return the widget id.

impl<S: State> WidgetChildrenExt<S> for Container<S>

fn set_children(&mut self, children: Vec<Val<S, impl Widget<S> + 'static>>)

Sets the child widgets of the widget.

fn add_child<W: Widget<S> + 'static>(&mut self, child: impl Into<Val<S, W>>)

Adds a child widget to the widget.

fn with_children(self, children: Vec<Val<S, impl Widget<S> + 'static>>) -> Self

where Self: Sized,

Sets the child widgets of the widget and returns self.

fn with_child<W: Widget<S> + 'static>(self, child: impl Into<Val<S, W>>) -> Self

where Self: Sized,

Adds a child widget to the widget and returns self.

impl<S: State> WidgetLayoutExt<S> for Container<S>

fn set_layout_style(&mut self, layout_style: impl Into<Val<S, LayoutStyle>>)

Sets the layout style of the widget.

fn with_layout_style(self, layout_style: impl Into<Val<S, LayoutStyle>>) -> Self

where Self: Sized,

Sets the layout style of the widget and returns self.