Struct WidgetPod 

pub struct WidgetPod { /* private fields */ }

A retained widget plus its layout results and dirty state.

The “pod” wraps the boxed widget with the bookkeeping the framework owns: where the widget 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, where the concrete type is no longer nameable.

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.

The concrete type is gone by the time the box arrives, so type_name reports ERASED_TYPE_NAME. Prefer WidgetPod::new_typed where the concrete type is still in scope.

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

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

Pass the widget itself, never an already-boxed Box<dyn Widget>: the blanket Widget for Box<dyn Widget> impl would make that compile while recording the box’s own type name and double-boxing the widget (which breaks the downcast back to the originating view’s element type). Use WidgetPod::new for the erased case.

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 when the pod was built from an already-erased box.

Recorded at construction, which is sound here because a root pod’s element type is fixed by RenderRoot<State, V>’s V and cannot swap under it. A ChildPod, whose widget can be swapped by a rebuild, asks the live widget instead (Widget::type_name).

Diagnostic only: type_name’s output is not a stable contract across compiler versions, so 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 (an inspector shows it beside the type name). Purely descriptive — nothing in the build/layout/paint path 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).