Struct EventCtx 

pub struct EventCtx { /* private fields */ }

Capabilities granted to a widget while it handles an event.

Widgets do not mutate the runtime directly: they set request flags here, and the runtime applies them after dispatch completes.

Implementations

impl EventCtx

pub fn is_consumed(&self) -> bool

Returns true if a widget has called Self::consume_event during this dispatch. Used by parent containers to decide whether to keep routing the event.

pub fn consume_event(&mut self)

Mark the current event as handled. Parent containers stop routing once they see this flag, so the same keystroke doesn’t fire two actions (e.g., a default button’s Enter accelerator stopping the focused list from also reacting to the keypress).

pub fn request_paint(&mut self)

Mark the window dirty so the runtime repaints on the next idle tick.

pub fn close(&mut self)

Ask the runtime to close the window after this dispatch completes.

pub fn is_focus_requested(&self) -> bool

true if a widget called Self::request_focus during this dispatch. Custom container widgets (outside saudade) read this after forwarding an event to a child to learn the child wants focus, then call Self::clear_focus_flags and move focus to it — the same protocol the built-in Container / Column use internally.

pub fn is_focus_released(&self) -> bool

true if a widget called Self::release_focus during this dispatch.

pub fn clear_focus_flags(&mut self)

Reset both focus-change flags after a custom container has acted on them.

pub fn request_focus(&mut self)

The widget asks to become the keyboard-focused widget. Parent containers observe this flag during pointer dispatch and route subsequent keyboard events here.

pub fn release_focus(&mut self)

The widget asks to drop keyboard focus. Useful when an editor wants the window to stop sending it characters.

pub fn request_dismiss(&mut self)

Content inside a modal dialog calls this to ask the hosting Modal to close — e.g. from an OK / Close button’s on_click. The modal runs its on_dismiss handler and dismisses after the current event finishes dispatching.

pub fn is_dismiss_requested(&self) -> bool

true if a widget called Self::request_dismiss during this dispatch. Read by Modal after forwarding an event to its content.