Struct Column

pub struct Column<'a, Message, Theme = Theme, Renderer = Renderer> { /* private fields */ }

Available on crate feature applet only.

A container that distributes its contents vertically.

Example

use iced::widget::{button, column};

#[derive(Debug, Clone)]
enum Message {
    // ...
}

fn view(state: &State) -> Element<'_, Message> {
    column![
        "I am on top!",
        button("I am in the center!"),
        "I am below.",
    ].into()
}

Implementations

impl<'a, Message, Theme, Renderer> Column<'a, Message, Theme, Renderer>

where Renderer: Renderer,

pub fn new() -> Self

Creates an empty Column.

pub fn with_capacity(capacity: usize) -> Self

Creates a Column with the given capacity.

pub fn with_children( children: impl IntoIterator<Item = Element<'a, Message, Theme, Renderer>>, ) -> Self

Creates a Column with the given elements.

pub fn from_vec(children: Vec<Element<'a, Message, Theme, Renderer>>) -> Self

Creates a Column from an already allocated Vec.

Keep in mind that the Column will not inspect the Vec, which means it won’t automatically adapt to the sizing strategy of its contents.

If any of the children have a Length::Fill strategy, you will need to call Column::width or Column::height accordingly.

pub fn spacing(self, amount: impl Into<Pixels>) -> Self

Sets the vertical spacing between elements.

Custom margins per element do not exist in iced. You should use this method instead! While less flexible, it helps you keep spacing between elements consistent.

pub fn padding<P: Into<Padding>>(self, padding: P) -> Self

Sets the Padding of the Column.

pub fn width(self, width: impl Into<Length>) -> Self

Sets the width of the Column.

pub fn height(self, height: impl Into<Length>) -> Self

Sets the height of the Column.

pub fn max_width(self, max_width: impl Into<Pixels>) -> Self

Sets the maximum width of the Column.

pub fn align_x(self, align: impl Into<Horizontal>) -> Self

Sets the horizontal alignment of the contents of the Column .

pub fn clip(self, clip: bool) -> Self

Sets whether the contents of the Column should be clipped on overflow.

pub fn push( self, child: impl Into<Element<'a, Message, Theme, Renderer>>, ) -> Self

Adds an element to the Column.

pub fn push_maybe( self, child: Option<impl Into<Element<'a, Message, Theme, Renderer>>>, ) -> Self

Adds an element to the Column, if Some.

pub fn extend( self, children: impl IntoIterator<Item = Element<'a, Message, Theme, Renderer>>, ) -> Self

Extends the Column with the given children.

Trait Implementations

impl<Message, Renderer> Default for Column<'_, Message, Renderer>

where Renderer: Renderer,

fn default() -> Self

Returns the “default value” for a type.

impl<'a, Message, Theme, Renderer> From<Column<'a, Message, Theme, Renderer>> for Element<'a, Message, Theme, Renderer>

where Message: 'a, Theme: 'a, Renderer: Renderer + 'a,

fn from(column: Column<'a, Message, Theme, Renderer>) -> Self

Converts to this type from the input type.

impl<'a, Message, Theme, Renderer: Renderer> FromIterator<Element<'a, Message, Theme, Renderer>> for Column<'a, Message, Theme, Renderer>

fn from_iter<T: IntoIterator<Item = Element<'a, Message, Theme, Renderer>>>( iter: T, ) -> Self

Creates a value from an iterator.

impl<Message, Theme, Renderer> Widget<Message, Theme, Renderer> for Column<'_, Message, Theme, Renderer>

where Renderer: Renderer,

fn a11y_nodes( &self, layout: Layout<'_>, state: &Tree, cursor: Cursor, ) -> A11yTree

get the a11y nodes for the widget

fn children(&self) -> Vec<Tree>

Returns the state Tree of the children of the Widget.

fn state(&self) -> State

Returns the State of the Widget.

fn tag(&self) -> Tag

Returns the Tag of the Widget.

fn diff(&mut self, tree: &mut Tree)

Reconciles the Widget with the provided Tree.

fn size(&self) -> Size<Length>

Returns the Size of the Widget in lengths.

fn layout( &mut self, tree: &mut Tree, renderer: &Renderer, limits: &Limits, ) -> Node

Returns the layout::Node of the Widget.

fn operate( &mut self, tree: &mut Tree, layout: Layout<'_>, renderer: &Renderer, operation: &mut dyn Operation, )

Applies an Operation to the Widget.

fn update( &mut self, tree: &mut Tree, event: &Event, layout: Layout<'_>, cursor: Cursor, renderer: &Renderer, clipboard: &mut dyn Clipboard, shell: &mut Shell<'_, Message>, viewport: &Rectangle, )

Processes a runtime Event.

fn mouse_interaction( &self, tree: &Tree, layout: Layout<'_>, cursor: Cursor, viewport: &Rectangle, renderer: &Renderer, ) -> Interaction

Returns the current mouse::Interaction of the Widget.

fn draw( &self, tree: &Tree, renderer: &mut Renderer, theme: &Theme, style: &Style, layout: Layout<'_>, cursor: Cursor, viewport: &Rectangle, )

Draws the Widget using the associated Renderer.

fn overlay<'b>( &'b mut self, tree: &'b mut Tree, layout: Layout<'b>, renderer: &Renderer, viewport: &Rectangle, translation: Vector, ) -> Option<Element<'b, Message, Theme, Renderer>>

Returns the overlay of the Widget, if there is any.

fn drag_destinations( &self, state: &Tree, layout: Layout<'_>, renderer: &Renderer, dnd_rectangles: &mut DndDestinationRectangles, )

Adds the drag destination rectangles of the widget. Runs after the layout phase for each widget in the tree.

fn size_hint(&self) -> Size<Length>

Returns a Size hint for laying out the Widget.

fn id(&self) -> Option<Id>

Returns the id of the widget

fn set_id(&mut self, _id: Id)

Sets the id of the widget This may be called while diffing the widget tree