Struct Mounted 

pub struct Mounted { /* private fields */ }

A widget tree mounted on a surface of a known size.

Implementations

impl Mounted

pub fn new(root: Box<dyn Widget>, width: f32, height: f32) -> Self

Mount root on a width x height surface. The tree is laid out at once, so the first event already hits the right bounds, and the first frame paints.

pub fn dispatch(&mut self, event: &Event) -> bool

Give one input event to the tree. Any message a widget emits is queued for take_messages. Every event owes a repaint, because widgets change hover and pressed state without emitting a message. Returns whether a message was emitted.

pub fn frame(&mut self) -> Frame

Run one frame tick. Every brick in the tree is verified before anything is painted; one failure anywhere blocks the whole frame (PROBAR-SPEC-009).

pub fn set_animating(&mut self, animating: bool)

Repaint on every tick (a waveform, a video overlay) or only when dirty.

pub fn request_repaint(&mut self)

Owe a repaint without an event (the app changed the tree).

pub const fn needs_frame(&self) -> bool

Whether the next tick would paint.

pub fn take_messages(&mut self) -> Vec<Box<dyn Any + Send>>

Messages emitted by widgets since the last call, oldest first.

pub const fn frames_painted(&self) -> u64

Frames painted so far.

pub fn root_mut(&mut self) -> &mut dyn Widget

The mounted tree, for the app to change between frames.

pub fn set_root(&mut self, root: Box<dyn Widget>)

Replace the tree (the app rebuilt it from new state); lays it out and owes a repaint.

pub const fn size(&self) -> Size

The surface size the tree is laid out for.