Struct Row 

pub struct Row<W> { /* private fields */ }

A container that distributes its contents horizontally.

Example

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

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

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

Implementations

impl<W> Row<W>

pub fn new() -> Self

Creates an empty Row.

pub fn with_capacity(capacity: usize) -> Self

Creates a Row with the given capacity.

pub fn with_children(children: impl IntoIterator<Item = W>) -> Self

where W: Meta,

Creates a Row with the given widgets.

pub fn from_vec(children: Vec<W>) -> Self

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>) -> Self

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: Into<Padding>>(self, padding: P) -> Self

Sets the [Padding] of the Row.

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

Sets the width of the Row.

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

Sets the height of the Row.

pub fn align_y(self, align: impl Into<Vertical>) -> Self

Sets the vertical alignment of the contents of the Row .

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

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

pub fn push(self, child: W) -> Self

where W: Meta,

Adds a [Widget] to the Row.

pub fn extend(self, children: impl IntoIterator<Item = W>) -> Self

where W: Meta,

Extends the Row with the given children.

pub fn wrap(self) -> Wrapping<W>

Turns the Row into a Wrapping row.

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

Trait Implementations

impl<W> Default for Row<W>

fn default() -> Self

Returns the “default value” for a type.

impl<W> FromIterator<W> for Row<W>

where W: Meta,

fn from_iter<T: IntoIterator<Item = W>>(iter: T) -> Self

Creates a value from an iterator.

impl<W> Meta for Row<W>

fn is_void(&self) -> bool

Returns whether the [Widget] is Void.

impl<W, Message, Theme, Renderer> Widget<Message, Theme, Renderer> for Row<W>

where W: Widget<Message, Theme, Renderer>, Renderer: Renderer,

fn tag(&self) -> Tag

Returns the Tag of the [Widget].

fn state(&self) -> State

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

Lays out the [Widget].

fn operate( &mut self, tree: &mut Tree, layout: Layout, viewport: &Rectangle, 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, 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, renderer: &Renderer, viewport: &Rectangle, translation: Vector, window: Size, ) -> Vec<Element<'b, Message, Theme, Renderer>>

Returns the overlays of the [Widget].

fn _map<F, B>(self, f: F) -> Map<Self, F, Message>

where Self: Sized, F: Fn(Message) -> B,

Applies a transformation to the produced message of this [Widget], returning a [Map].

fn _boxed<'a>(self) -> Element<'a, Message, Theme, Renderer>

where Self: Sized + 'a,

Boxes this [Widget], turning it into a generic [Element].