Struct CotisLayoutRun 

pub struct CotisLayoutRun<'layout, Config> { /* private fields */ }

Per-frame element tree configurator returned by LayoutManager::begin_frame.

Implements ConfigureElements when Config implements CotisLayoutCompatible. Call LayoutFrameManager::end (or finalize_layouts directly) to run layout and obtain RenderCommandOutput values.

Implementations

impl<'layout, Config> CotisLayoutRun<'layout, Config>

pub fn new(layout_manager: &'layout mut CotisLayoutManager) -> Self

Starts a new frame: clears the live tree and opens the root element.

pub fn get_tree_cursor(&mut self) -> LayoutTreeCursor<'_>

Returns a mutable cursor to the currently open element in the layout tree.

Panics

Panics if the open element index is invalid (internal inconsistency).

pub fn new_child_element(&mut self)

Adds a new child under the currently open element and opens it.

Panics

Panics if the open element no longer exists in the tree.

pub fn set_open_element_config( &mut self, config: LayoutElementConfig, id: ElementId, name: Option<OwnedOrRef<'_, str>>, true_config: Config, )

Applies layout style and user config to the currently open element, then initializes sizing state.

Called internally by ConfigureElements::set_config.

Panics

Panics if no element is open.

pub fn open_element_id(&self) -> ElementId

Returns the ElementId of the currently open tree node.

Panics

Panics if no element is open.

pub fn close_open_element(&mut self)

Finalizes sizing for the open element and moves the cursor to its parent.

pub fn finalize_layouts(&mut self) -> Vec<RenderCommandOutput<Config>>

Runs the full layout pipeline and returns render commands for this frame.

Order: fit/grow/shrink (width) → text wrap → fit/grow/shrink (height) → positioning → render command emission. Clears the live tree and populates the manager’s element cache for inspection traits.

Prefer LayoutFrameManager::end when using the standard Cotis frame API.

pub fn remove_custom(&mut self, element_id: ElementId) -> Config

Removes and returns the user config for element_id after render command extraction.

Panics

Panics if no config exists for element_id.

Trait Implementations

impl<'name, T> ConfigureElements<T> for CotisLayoutRun<'_, T>

where T: CotisLayoutCompatible<'name>,

fn open_new_element(&mut self, _: Seal)

Signals the start of a new element

fn set_config(&mut self, config: T, _: Seal)

fn close_element(&mut self, _: Seal)

impl<'frame, I, C, E: 'frame + Sync + Send> ConfigureLeafElements<TextElementConfig<'frame>> for CotisLayoutRun<'_, ElementConfig<'frame, Sizing, I, C, E>>

fn set_leaf_config(&mut self, leaf: TextElementConfig<'frame>, _: Seal)

Sets configuration intended for leaf-only element data.

impl<'frame, I, C, E: 'frame + Sync + Send> ConfigureLeafElements<TextElementConfig<'frame>> for CotisLayoutRun<'_, ElementConfig<'frame, DoubleAxisSizing, I, C, E>>

fn set_leaf_config(&mut self, leaf: TextElementConfig<'frame>, _: Seal)

Sets configuration intended for leaf-only element data.

impl<'frame, T> LayoutFrameManager<'frame, T, RenderCommandOutput<T>, CotisLayoutRun<'_, T>> for CotisLayoutRun<'_, T>

where T: CotisLayoutCompatible<'frame> + 'frame,

fn begin(&mut self) -> ConfiguredParentElement<'_, Self, T>

Begins configuration at the root of the UI tree for this frame.

fn end(self) -> impl Iterator<Item = RenderCommandOutput<T>>

Completes frame construction and returns the frame output iterator.