Struct SortingList 

pub struct SortingList { /* private fields */ }

Represents a sorted view into an UiNode::is_list.

The underlying list is not changed, a sorted index map is used to iterate the underlying list.

The sorting is lazy and gets invalidated on every init and every time there are changes observed in update_list.

Methods measure_list, layout_list, render, for_each_child and par_each_child are the only that iterate sorted. Method with_child uses the sort index. Method update_list notifies a reset if there is any change in the list or sorting. Other methods delegate to the unsorted list.

Implementations

impl SortingList

pub fn new( list: impl IntoUiNode, sort: impl Fn(&mut UiNode, &mut UiNode) -> Ordering + Send + 'static, ) -> Self

New from list and sort function.

pub fn list(&mut self) -> &mut UiNode

Mutable borrow the inner list.

You must call invalidate_sort if any modification is done to the list.

pub fn invalidate_sort(&mut self)

Invalidate the sort, the list will resort on the nest time the sorted positions are needed.

Note that you can also invalidate sort from the inside using SORTING_LIST::invalidate_sort.

pub fn chain(self, other: impl IntoUiNode) -> UiNode

Create a list chain node.

See UiNode::chain for more details.

Trait Implementations

impl UiNodeImpl for SortingList

fn children_len(&self) -> usize

Gets the current count of children nodes.

fn with_child(&mut self, index: usize, visitor: &mut dyn FnMut(&mut UiNode))

Visit a child node by index. If the index is not valid visitor is not called.

fn is_list(&self) -> bool

Gets if the node represents a list of other nodes.

fn for_each_child(&mut self, visitor: &mut dyn FnMut(usize, &mut UiNode))

Call visitor for each child node of self, one at a time.

fn try_for_each_child( &mut self, visitor: &mut dyn FnMut(usize, &mut UiNode) -> ControlFlow<BoxAnyVarValue>, ) -> ControlFlow<BoxAnyVarValue>

Call visitor for each child node of self, one at a time, with control flow.

fn par_each_child(&mut self, visitor: &(dyn Fn(usize, &mut UiNode) + Sync))

Calls visitor for each child node in parallel.

fn par_fold_reduce( &mut self, identity: BoxAnyVarValue, fold: &(dyn Fn(BoxAnyVarValue, usize, &mut UiNode) -> BoxAnyVarValue + Sync), _: &(dyn Fn(BoxAnyVarValue, BoxAnyVarValue) -> BoxAnyVarValue + Sync), ) -> BoxAnyVarValue

Calls fold for each child node in parallel, with fold accumulators produced by cloning identity, then merges the folded results using reduce to produce the final value also in parallel.

fn init(&mut self)

Initializes the node in a new UI context.

fn deinit(&mut self)

Deinitializes the node in the current UI context.

fn info(&mut self, info: &mut WidgetInfoBuilder)

Builds widget info.

fn event(&mut self, update: &EventUpdate)

Receives an event.

fn update(&mut self, updates: &WidgetUpdates)

Receives variable and other non-event updates.

fn update_list( &mut self, updates: &WidgetUpdates, observer: &mut dyn UiNodeListObserver, )

Does update and if the node is a list notifies list changes to the observer.

fn measure(&mut self, wm: &mut WidgetMeasure) -> PxSize

Computes the widget size given the contextual layout metrics without actually updating the widget layout.

fn measure_list( &mut self, wm: &mut WidgetMeasure, measure: &(dyn Fn(usize, &mut UiNode, &mut WidgetMeasure) -> PxSize + Sync), fold_size: &(dyn Fn(PxSize, PxSize) -> PxSize + Sync), ) -> PxSize

If the node is_list measure each child and combine the size using fold_size.

fn layout(&mut self, wl: &mut WidgetLayout) -> PxSize

Computes the widget layout given the contextual layout metrics.

fn layout_list( &mut self, wl: &mut WidgetLayout, layout: &(dyn Fn(usize, &mut UiNode, &mut WidgetLayout) -> PxSize + Sync), fold_size: &(dyn Fn(PxSize, PxSize) -> PxSize + Sync), ) -> PxSize

If the node is_list layout each child and combine the size using fold_size.

fn render(&mut self, frame: &mut FrameBuilder)

Generates render instructions and updates transforms and hit-test areas.

fn render_list( &mut self, frame: &mut FrameBuilder, render: &(dyn Fn(usize, &mut UiNode, &mut FrameBuilder) + Sync), )

If the node is_list render each child.

fn render_update(&mut self, update: &mut FrameUpdate)

Updates values in the last generated frame.

fn render_update_list( &mut self, update: &mut FrameUpdate, render_update: &(dyn Fn(usize, &mut UiNode, &mut FrameUpdate) + Sync), )

If the node is_list render_update each child.

fn as_widget(&mut self) -> Option<&mut dyn WidgetUiNodeImpl>

Gets the node implementation as a WidgetUiNodeImpl, if the node defines a widget instance scope.