Struct Widget 

pub struct Widget {
    pub kind: WidgetKind,
    pub id: Option<String>,
    pub style: Style,
    pub flex_dir: FlexDir,
    pub children: Vec<Widget>,
    pub on_click: Option<String>,
    pub enabled: bool,
    pub focused: bool,
}

A single widget in the UI tree.

Fields

kind: WidgetKind

id: Option<String>

style: Style

flex_dir: FlexDir

children: Vec<Widget>

on_click: Option<String>

enabled: bool

focused: bool

Implementations

impl Widget

pub fn id(self, id: impl Into<String>) -> Widget

pub fn on_click(self, ev: impl Into<String>) -> Widget

pub fn child(self, w: Widget) -> Widget

pub fn w(self, w: impl Into<Units>) -> Widget

Accepts a plain px value (0.0 = auto) or a Units directly — e.g. .w(18.0) or .w(Units::Percent(60.0)).

pub fn h(self, h: impl Into<Units>) -> Widget

pub fn min_w(self, v: f32) -> Widget

pub fn min_h(self, v: f32) -> Widget

pub fn flex(self, v: f32) -> Widget

pub fn flex_dir(self, v: FlexDir) -> Widget

pub fn gap(self, v: f32) -> Widget

pub fn bg(self, v: u32) -> Widget

pub fn color(self, v: u32) -> Widget

pub fn align(self, v: Align) -> Widget

pub fn font_scale(self, v: f32) -> Widget

pub fn shadow(self, v: bool) -> Widget

pub fn no_wrap(self) -> Widget

pub fn focus_style(self, v: FocusStyle) -> Widget

pub fn focus_color(self, v: u32) -> Widget

pub fn dock(self, v: Dock) -> Widget

pub fn enabled(self, v: bool) -> Widget

pub fn focused(self, v: bool) -> Widget

pub fn at(self, x: f32, y: f32) -> Widget

Position absolutely at (x, y) inside the parent’s content box — see Style::pos.

pub fn ellipsis(self) -> Widget

Single line, cut with ... when too wide — see Style::ellipsis.

pub fn clip(self, v: bool) -> Widget

Clip children to this widget’s rect — see Style::clip.

pub fn scroll_y(self, v: f32) -> Widget

Vertical scroll offset of the children — see Style::scroll_y.

pub fn scrollbar(self, v: bool) -> Widget

Draw a vertical scrollbar on overflow — see Style::scrollbar.

pub fn font(self, font: impl Into<String>) -> Widget

Font for this widget’s text — see Style::font.

pub fn placeholder(self, text: impl Into<String>) -> Widget

Text box: greyed text shown while it’s empty.

pub fn max_length(self, n: usize) -> Widget

Text box: longest text allowed, in characters (0 = unlimited).

pub fn on_change(self, ev: impl Into<String>) -> Widget

Text box: event name raised when the text changes.

pub fn on_submit(self, ev: impl Into<String>) -> Widget

Text box: event name raised by Enter.

pub fn stretch(self, stretch: Stretch) -> Widget

Image: how it fills the widget (WPF’s Stretch).

pub fn region(self, region: [f32; 4]) -> Widget

Image: draw only [u, v, w, h] of it (texture pixels).

pub fn tint(self, tint: u32) -> Widget

Image: multiply its colors by tint (0xAARRGGBB).

pub fn children(self, children: impl IntoIterator<Item = Widget>) -> Widget

Adds every widget in children, in order.

pub fn find_mut(&mut self, id: &str) -> Option<&mut Widget>

The first widget in this subtree (depth-first, self included) whose Widget::id is id — for changing a built tree before laying it out (dynamic text, enabled state, …).

pub fn set_text(&mut self, text: impl Into<String>) -> bool

Replaces the text of a label, button or text box; false for any other kind.

pub fn padding(self, top: f32, right: f32, bottom: f32, left: f32) -> Widget

pub fn margin(self, top: f32, right: f32, bottom: f32, left: f32) -> Widget

Trait Implementations

impl Clone for Widget

fn clone(&self) -> Widget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Widget

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

Formats the value using the given formatter.