Enum druid::InternalLifeCycle

pub enum InternalLifeCycle {
    RouteWidgetAdded,
    RouteFocusChanged {
        old: Option<WidgetId>,
        new: Option<WidgetId>,
    },
    RouteDisabledChanged,
    RouteViewContextChanged(ViewContext),
    DebugRequestState {
        widget: WidgetId,
        state_cell: StateCell,
    },
    DebugRequestDebugState {
        widget: WidgetId,
        state_cell: DebugStateCell,
    },
    DebugInspectState(StateCheckFn),
}

Internal lifecycle events used by Druid inside WidgetPod.

These events are translated into regular LifeCycle events and should not be used directly.

Variants

RouteWidgetAdded

Used to route the WidgetAdded event to the required widgets.

RouteFocusChanged

Fields

old: Option<WidgetId>

the widget that is losing focus, if any

new: Option<WidgetId>

the widget that is gaining focus, if any

Used to route the FocusChanged event.

RouteDisabledChanged

Used to route the DisabledChanged event to the required widgets.

RouteViewContextChanged(ViewContext)

Used to route the ViewContextChanged event to the required widgets.

DebugRequestState

Fields

widget: WidgetId

the widget whose state is requested

state_cell: StateCell

a cell used to store the a widget’s state

For testing: request the WidgetState of a specific widget.

During testing, you may wish to verify that the state of a widget somewhere in the tree is as expected. In that case you can dispatch this event, specifying the widget in question, and that widget will set its state in the provided Cell, if it exists.

DebugRequestDebugState

Fields

widget: WidgetId

the widget whose state is requested

state_cell: DebugStateCell

a cell used to store the a widget’s state

For testing: request the DebugState of a specific widget.

This is useful if you need to get a best-effort description of the state of this widget and its children. You can dispatch this event, specifying the widget in question, and that widget will set its state in the provided Cell, if it exists.

DebugInspectState(StateCheckFn)

For testing: apply the given function on every widget.

Implementations

impl InternalLifeCycle

pub fn should_propagate_to_hidden(&self) -> bool

Whether this event should be sent to widgets which are currently not visible and not accessible.

If a widget changes which children are hidden it must call children_changed. For a more detailed explanation of the hidden state, see Event::should_propagate_to_hidden.

Trait Implementations

impl Clone for InternalLifeCycle

fn clone(&self) -> InternalLifeCycle

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for InternalLifeCycle

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

Formats the value using the given formatter.