Struct Row

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

A container that distributes its contents horizontally.

Example

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

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

fn view(state: &State) -> Element<'_, Message> {
    row![
        "I am to the left!",
        button("I am in the middle!"),
        "I am to the right!",
    ].into()
}

Implementations

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

where Renderer: Renderer,

pub fn new() -> Row<'a, Message, Theme, Renderer>

Creates an empty Row.

pub fn with_capacity(capacity: usize) -> Row<'a, Message, Theme, Renderer>

Creates a Row with the given capacity.

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

Creates a Row with the given elements.

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

Creates a Row from an already allocated Vec.

Keep in mind that the Row 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 Row::width or Row::height accordingly.

pub fn spacing( self, amount: impl Into<Pixels>, ) -> Row<'a, Message, Theme, Renderer>

Sets the horizontal 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>(self, padding: P) -> Row<'a, Message, Theme, Renderer>

where P: Into<Padding>,

Sets the Padding of the Row.

pub fn width( self, width: impl Into<Length>, ) -> Row<'a, Message, Theme, Renderer>

Sets the width of the Row.

pub fn height( self, height: impl Into<Length>, ) -> Row<'a, Message, Theme, Renderer>

Sets the height of the Row.

pub fn align_y( self, align: impl Into<Vertical>, ) -> Row<'a, Message, Theme, Renderer>

Sets the vertical alignment of the contents of the Row .

pub fn clip(self, clip: bool) -> Row<'a, Message, Theme, Renderer>

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

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

Adds an Element to the Row.

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

Adds an element to the Row, if Some.

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

Extends the Row with the given children.

pub fn wrap(self) -> Wrapping<'a, Message, Theme, Renderer>

Turns the Row into a [Wrapping] row.

The original alignment of the Row is preserved per row wrapped.

Trait Implementations

impl<'a, Message, Renderer> Default for Row<'a, Message, Renderer>

where Renderer: Renderer,

fn default() -> Row<'a, Message, Renderer>

Returns the “default value” for a type.

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

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

fn from( row: Row<'a, Message, Theme, Renderer>, ) -> Element<'a, Message, Theme, Renderer>

Converts to this type from the input type.

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

where Renderer: Renderer,

fn from_iter<T>(iter: T) -> Row<'a, Message, Theme, Renderer>

where T: IntoIterator<Item = Element<'a, Message, Theme, Renderer>>,

Creates a value from an iterator.

impl<'a, Message, Theme, Renderer> Widget<Message, Theme, Renderer> for Row<'a, 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 diff(&mut self, tree: &mut Tree)

Reconciliates the Widget with the provided Tree.

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

Returns the Size of the Widget in lengths.

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

Returns the layout::Node of the Widget.

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

Applies an Operation to the Widget.

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

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<'_>, renderer: &Renderer, 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 tag(&self) -> Tag

Returns the Tag of the Widget.

fn state(&self) -> State

Returns the State of 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