Struct WidgetPod 

pub struct WidgetPod { /* private fields */ }

A retained widget plus its layout results and dirty state: where it was placed (origin), how big it is (size), and which passes are pending (flags).

Implementations

impl WidgetPod

pub const ERASED_TYPE_NAME: &'static str = "<erased dyn Widget>"

The type_name recorded for a pod built from an already type-erased widget.

pub fn new(id: WidgetId, widget: Box<dyn Widget>) -> Self

Wrap a freshly built, already type-erased widget; it starts dirty for layout and paint. type_name reports ERASED_TYPE_NAME; prefer WidgetPod::new_typed where the concrete type is in scope.

pub fn new_typed<W: Widget>(id: WidgetId, widget: W) -> Self

Wrap a freshly built widget whose concrete type is in scope, recording its core::any::type_name.

Pass the widget itself, never a Box<dyn Widget>: the blanket Widget for Box<dyn Widget> impl would compile but record the box’s type name and double-box the widget, breaking the downcast to the view’s element type.

pub fn id(&self) -> WidgetId

This pod’s stable identity.

pub fn type_name(&self) -> &'static str

The concrete widget type’s name, or ERASED_TYPE_NAME.

Recorded at construction, sound because a root pod’s element type is fixed by RenderRoot<State, V>; a swappable ChildPod asks the live widget (Widget::type_name). Diagnostic only: never parse or match on it.

pub fn debug_label(&self) -> Option<&str>

The human name attached for tooling, if any. None by default.

pub fn set_debug_label(&mut self, label: impl Into<Cow<'static, str>>)

Attach a human name for tooling; nothing in build/layout/paint reads it.

pub fn clear_debug_label(&mut self)

Drop any attached debug label.

pub fn widget(&self) -> &dyn Widget

Shared access to the boxed widget.

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

Mutable access to the boxed widget.

pub fn origin(&self) -> Point

The widget’s origin in its parent’s coordinate space.

pub fn size(&self) -> Size

The widget’s resolved size (valid after a layout pass).

pub fn set_layout(&mut self, origin: Point, size: Size)

Record the geometry produced by a layout pass.

pub fn flags(&self) -> ChangeFlags

The pending pass flags for this pod.

pub fn merge_flags(&mut self, flags: ChangeFlags)

Merge additional pending flags (e.g. from a rebuild).

pub fn clear_flags(&mut self)

Clear all pending flags (after the corresponding passes have run).