Struct BehaviorCollection 

pub struct BehaviorCollection(/* private fields */);

Represents a collection of IBehaviors with a shared associated_object.

The collection is a notifying list of objects (FerroList<FerroObject>); every item must be a behavior. It is a reference object: clones refer to the same collection and compare by identity.

Implementations

impl BehaviorCollection

pub fn new() -> Self

Initializes a new instance of the BehaviorCollection class.

pub fn list(&self) -> &FerroList<Ref<FerroObject>>

The list of the collection.

pub fn associated_object(&self) -> Option<Ref<FerroObject>>

Gets the object to which the BehaviorCollection is attached.

pub fn attach(&self, associated_object: impl Into<Nullable<FerroObject>>)

Attaches the collection of behaviors to the specified object.

Panics

Panics if the BehaviorCollection is already attached to a different object.

pub fn detach(&self)

Detaches the collection of behaviors from the associated_object.

Methods from Deref<Target = FerroList<Ref<FerroObject>>>

pub fn ptr_eq(&self, other: &FerroList<T>) -> bool

Whether two handles refer to the same list.

pub fn add_collection_changed( &self, handler: Rc<dyn for<'a> Fn(&NotifyCollectionChangedEventArgs<'a, T>)>, ) -> u64

Subscribes to changes. Returns a token for remove_collection_changed.

pub fn remove_collection_changed(&self, token: u64) -> bool

Unsubscribes a handler.

pub fn has_collection_changed_subscribers(&self) -> bool

Whether anything is subscribed to changes, typed or untyped.

pub fn count(&self) -> usize

The number of items in the list.

pub fn is_empty(&self) -> bool

pub fn capacity(&self) -> usize

The number of items the list can hold before its storage grows.

pub fn set_capacity(&self, capacity: usize)

Sets the number of items the list can hold before its storage grows.

Panics

Panics if capacity is less than the number of items, as the managed original throws.

pub fn reset_behavior(&self) -> ResetBehavior

The reset behavior of the list.

pub fn set_reset_behavior(&self, value: ResetBehavior)

pub fn validate(&self) -> Option<Rc<dyn Fn(&T)>>

where T: 'static,

The validation routine that is invoked for every item before it is added to the list.

pub fn set_validate(&self, value: Option<Rc<dyn Fn(&T)>>)

where T: 'static,

Sets a validation routine that is invoked for every item before it is added to the list; it rejects an item by panicking.

pub fn validator(&self) -> Option<Rc<dyn IFerroListItemValidator<T>>>

where T: 'static,

The validator that is invoked for every item before it is added to the list.

pub fn set_validator(&self, value: Option<Rc<dyn IFerroListItemValidator<T>>>)

pub fn get(&self, index: usize) -> T

The item at index. Panics if out of range.

pub fn try_get(&self, index: usize) -> Option<T>

The item at index, if in range.

pub fn set(&self, index: usize, value: T)

where T: PartialEq,

Replaces the item at index.

pub fn snapshot(&self) -> Rc<Vec<T>>

A snapshot of the items. It stays valid and unchanged if the list is modified.

pub fn to_vec(&self) -> Vec<T>

Copies the items into a vector.

pub fn for_each(&self, f: impl FnMut(&T))

Calls f for each item of a snapshot of the list.

pub fn add(&self, item: T)

Adds an item to the collection.

pub fn add_range(&self, items: impl IntoIterator<Item = T>)

Adds multiple items to the collection.

pub fn insert(&self, index: usize, item: T)

Inserts an item at the specified index.

pub fn insert_range(&self, index: usize, items: impl IntoIterator<Item = T>)

Inserts multiple items at the specified index.

pub fn move_item(&self, old_index: usize, new_index: usize)

Moves an item to a new index.

pub fn move_range(&self, old_index: usize, count: usize, new_index: usize)

Moves multiple items to a new index.

pub fn remove_at(&self, index: usize)

Removes the item at the specified index.

pub fn remove_range(&self, index: usize, count: usize)

Removes a range of elements from the collection.

pub fn clear(&self)

Removes all items from the collection.

pub fn copy_to(&self, array: &mut [T], array_index: usize)

Copies the items into array, starting at array_index.

Panics

Panics if array is too small, as the managed original throws.

pub fn get_range(&self, index: usize, count: usize) -> Vec<T>

Gets a range of items from the collection.

pub fn ensure_capacity(&self, capacity: usize)

Ensures that the capacity of the list is at least capacity.

pub fn contains(&self, item: &T) -> bool

Tests whether the collection contains an item.

pub fn index_of(&self, item: &T) -> Option<usize>

The index of an item in the collection.

pub fn remove(&self, item: &T) -> bool

Removes an item from the collection. Returns true if it was present.

pub fn remove_all(&self, items: impl IntoIterator<Item = T>)

Removes multiple items from the collection.

Each run of adjacent items that are removed is notified as one removal, from the end of the list to its start.

Trait Implementations

impl Clone for BehaviorCollection

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BehaviorCollection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BehaviorCollection

fn default() -> Self

Returns the “default value” for a type.

impl Deref for BehaviorCollection

type Target = FerroList<Ref<FerroObject>>

The resulting type after dereferencing.

fn deref(&self) -> &FerroList<Ref<FerroObject>>

Dereferences the value.

impl MarkupTyped for BehaviorCollection

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl PartialEq for BehaviorCollection

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.