Struct ToastHandle 

pub struct ToastHandle { /* private fields */ }

Returned by Toast::present (and ctx.show_toast(toast)). Cheap to clone (Rc<Inner>). Lets app code dismiss the toast programmatically or check whether it is still alive.

Dropping the handle does NOT dismiss the toast — toasts have their own lifecycle managed by the host (timer + manual paths). The handle is the OPTIONAL “I want to control this toast later” hook.

Implementations

impl ToastHandle

pub fn entry_id(&self) -> u64

Stable per-toast id. Two ToastHandles pointing at the same underlying toast share the same entry_id. The id is unique per ToastRegistry (per app) — it doesn’t survive across app restarts.

pub fn is_alive(&self) -> bool

Whether the toast is still in the registry’s live set (timer hasn’t expired, user hasn’t dismissed, host hasn’t shut down). Always false for overflow-dropped toasts.

pub fn dismiss(&self, ctx: &mut EventContext<'_>)

Programmatically dismiss the toast with cause ToastDismissCause::Programmatic. No-op if the toast is already dismissed (timer, user, host shutdown).

Trait Implementations

impl Clone for ToastHandle

fn clone(&self) -> ToastHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToastHandle

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

Formats the value using the given formatter.