Struct zng_app::widget::node::ArcNodeList

pub struct ArcNodeList<L: UiNodeList>(/* private fields */);

A reference counted UiNodeList.

Nodes can only be used in one place at a time, this struct allows the creation of slots that are UiNodeList implementers that can exclusive take the referenced list as the children.

When a slot takes the list it is deinited in the previous place and reinited in the slot place.

Slots hold a strong reference to the list when they have it as their child and a weak reference when they don’t.

Implementations

impl<L: UiNodeList> ArcNodeList<L>

pub fn new(list: L) -> Self

New list.

pub fn new_cyclic(list: impl FnOnce(WeakNodeList<L>) -> L) -> Self

New rc list that contains a weak reference to itself.

Note that the weak reference cannot be upgraded during the call to list.

pub fn downgrade(&self) -> WeakNodeList<L>

Creates a WeakNodeList<L> reference to this list.

pub fn set(&self, new_list: L)

Replace the current list with the new_list in the current slot.

The previous list is deinited and the new_list is inited.

pub fn take_when(&self, var: impl IntoVar<bool>) -> TakeSlot<L, impl TakeOn>

Create a slot list that takes ownership of this list when var updates to true.

The slot node also takes ownership on init if the var is already true.

The return type implements UiNodeList.

pub fn take_on<A: EventArgs>( &self, event: Event<A>, filter: impl FnMut(&A) -> bool + Send + 'static, take_on_init: bool, ) -> TakeSlot<L, impl TakeOn>

Create a slot list that takes ownership of this list when event updates and filter returns true.

The slot list also takes ownership on init if take_on_init is true.

The return type implements UiNodeList.

pub fn take_on_init(&self) -> TakeSlot<L, impl TakeOn>

Create a slot node list that takes ownership of this list as soon as the node is inited.

This is equivalent to self.take_when(true).

pub fn for_each_ctx(&self, update_mode: WidgetUpdateMode, f: impl FnMut(usize))

Iterate over widget contexts.

Trait Implementations

impl<L: UiNodeList> Clone for ArcNodeList<L>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.