Struct egui::Layout

pub struct Layout { /* private fields */ }

The layout of a Ui, e.g. “vertical & centered”.

ui.with_layout(egui::Layout::right_to_left(egui::Align::TOP), |ui| {
    ui.label("world!");
    ui.label("Hello");
});

Implementations

impl Layout

Constructors

pub fn left_to_right(valign: Align) -> Self

Place elements horizontally, left to right.

The valign parameter controls how to align elements vertically.

pub fn right_to_left(valign: Align) -> Self

Place elements horizontally, right to left.

The valign parameter controls how to align elements vertically.

pub fn top_down(halign: Align) -> Self

Place elements vertically, top to bottom.

Use the provided horizontal alignmen.

pub fn top_down_justified(halign: Align) -> Self

Top-down layout justifed so that buttons etc fill the full available width.

pub fn bottom_up(halign: Align) -> Self

Place elements vertically, bottom up.

Use the provided horizontal alignmen.

pub fn from_main_dir_and_cross_align(
    main_dir: Direction,
    cross_align: Align
) -> Self

pub fn centered_and_justified(main_dir: Direction) -> Self

For when you want to add a single widget to a layout, and that widget should use up all available space.

pub fn with_main_wrap(self, main_wrap: bool) -> Self

Wrap widgets when we overflow the main axis?

For instance, for left-to-right layouts, setting this to true will put widgets on a new row if we would overflow the right side of crate::Ui::max_rect.

pub fn with_main_align(self, main_align: Align) -> Self

The alignment to use on the main axis.

pub fn with_cross_align(self, cross_align: Align) -> Self

The alignment to use on the cross axis.

The “cross” axis is the one orthogonal to the main axis. For instance: in left-to-right layout, the main axis is horizontal and the cross axis is vertical.

pub fn with_main_justify(self, main_justify: bool) -> Self

Justify widgets on the main axis?

Justify here means “take up all available space”.

pub fn with_cross_justify(self, cross_justify: bool) -> Self

Justify widgets along the cross axis?

Justify here means “take up all available space”.

The “cross” axis is the one orthogonal to the main axis. For instance: in left-to-right layout, the main axis is horizontal and the cross axis is vertical.

impl Layout

Inspectors

pub fn main_dir(&self) -> Direction

pub fn main_wrap(&self) -> bool

pub fn cross_align(&self) -> Align

pub fn cross_justify(&self) -> bool

pub fn is_horizontal(&self) -> bool

pub fn is_vertical(&self) -> bool

pub fn prefer_right_to_left(&self) -> bool

pub fn horizontal_placement(&self) -> Align

e.g. for adjusting the placement of something.

• in horizontal layout: left or right?
• in vertical layout: same as Self::horizontal_align.

pub fn horizontal_align(&self) -> Align

e.g. for when aligning text within a button.

pub fn vertical_align(&self) -> Align

e.g. for when aligning text within a button.

pub fn horizontal_justify(&self) -> bool

pub fn vertical_justify(&self) -> bool

impl Layout

Doing layout

pub fn align_size_within_rect(&self, size: Vec2, outer: Rect) -> Rect

Trait Implementations

impl Clone for Layout

fn clone(&self) -> Layout

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Layout

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

Formats the value using the given formatter.

impl Default for Layout

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq<Layout> for Layout

fn eq(&self, other: &Layout) -> 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 Copy for Layout

impl StructuralPartialEq for Layout