Struct SearchBar 

pub struct SearchBar { /* private fields */ }

Implementations

impl SearchBar

pub fn new(rect: Rect) -> Self

pub fn text(&self) -> String

Current query text.

pub fn clear(&mut self)

Clear the query.

Trait Implementations

impl Widget for SearchBar

fn bounds(&self) -> Rect

Logical bounds relative to the window root, in saudade pixels.

fn paint(&mut self, painter: &mut Painter<'_>, theme: &Theme)

Render the widget in the normal pass.

fn event(&mut self, event: &Event, ctx: &mut EventCtx)

Handle a typed input event. Default: ignore.

fn captures_pointer(&self) -> bool

Internal hook for capture-on-press dispatch. Default: never captured. Implementations like Button override this so pointer events keep flowing to them while a press is in progress, even if the cursor leaves the widget’s bounds.

fn focusable(&self) -> bool

true if this widget accepts keyboard focus. The parent container remembers the last focusable widget the user clicked, and routes keyboard events only there.

fn set_focused(&mut self, focused: bool)

Inform the widget that it has gained or lost keyboard focus. Default: ignore. Editing widgets override this to show/hide their cursor or to commit pending input.

fn focus_first(&mut self) -> bool

Try to give keyboard focus to this widget or one of its descendants. Returns true if a focusable target was located and now holds focus.

fn layout(&mut self, bounds: Rect)

Position the widget inside the rectangle the parent has allocated.

fn wants_ticks(&self) -> bool

true if this widget needs periodic Event::Tick events to drive an animation. The runtime polls this after every dispatch and, while any widget in the tree wants ticks, fires Tick at roughly 60 Hz. Container widgets propagate from children. Default: no animation.

fn paint_overlay(&mut self, _painter: &mut Painter<'_>, _theme: &Theme)

Render anything that needs to float on top of every sibling — open menu popups, tooltips, drag previews. Runs after every widget’s regular paint is finished. Default: no-op.

fn on_cancel(&mut self, _ctx: &mut EventCtx)

Called when the widget is cancelled — closed by Escape or a window’s close button (which the runtime maps to Escape), with no child consuming that Escape first — rather than dismissed by its own request. A hosting Modal calls it on its content just before tearing it down; the runtime calls it on the root widget when the main window is closed, so a dialog used directly as the window root gets the same hook. It does not fire when the content asked to be dismissed itself (e.g. an OK / Cancel button calling EventCtx::request_dismiss), since that path already chose what to commit or revert. A dialog that previews edits live overrides this to roll them back. Default: no-op.

fn accepts_accelerators(&self) -> bool

true if this widget should receive every keyboard event regardless of focus. Used by menu bars so that Alt+letter accelerators reach them even while a sibling (e.g., a text editor) holds focus.

fn popup_request(&self) -> Option<PopupRequest>

Ask the runtime to host a popup window for this widget. Returning Some makes the runtime open (or move) a borderless top-level window at the indicated logical-coord rect so the popup can extend past the main window’s edges. Container widgets propagate this from their children. Default: no popup.

fn collect_popups(&self, out: &mut Vec<PopupRequest>)

Collect every popup this widget and its descendants currently want the runtime to host, outermost first.