Struct FerroList 

pub struct FerroList<T>(/* private fields */);

A notifying list.

Enumeration works on a snapshot, so the list may be modified from within an enumeration or a change notification. The snapshot shares storage with the list and is only copied if the list is modified while it is alive.

The list is a reference object: the value is a shared handle, clones refer to the same list and handles compare by identity.

Implementations

impl<T> FerroList<T>

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

Whether two handles refer to the same list.

impl<T: Clone> FerroList<T>

pub fn new() -> Self

Creates an empty list.

pub fn from_items(items: impl IntoIterator<Item = T>) -> Self

Creates a list with initial items.

pub fn add_collection_changed( &self, handler: Rc<CollectionChangedHandler<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.

impl<T: Clone + PartialEq> FerroList<T>

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<T> Clone for FerroList<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for FerroList<T>

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

Formats the value using the given formatter.

impl<T: Clone> Default for FerroList<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T: Clone + PartialEq> IFerroList<T> for FerroList<T>

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

Sets the element at the specified index.

fn add(&self, item: T)

Adds an item to the collection.

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

Inserts an item at the specified index.

fn remove_at(&self, index: usize)

Removes the item at the specified index.

fn clear(&self)

Removes all items from the collection.

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

Tests whether the collection contains an item.

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

The index of an item in the collection.

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

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

fn add_range(&self, items: Vec<T>)

Adds multiple items to the collection.

fn insert_range(&self, index: usize, items: Vec<T>)

Inserts multiple items at the specified index.

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

Moves an item to a new index.

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

Moves multiple items to a new index.

fn remove_all(&self, items: Vec<T>)

Removes multiple items from the collection.

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

Removes a range of elements from the collection.

impl<T: Clone> IFerroReadOnlyList<T> for FerroList<T>

fn count(&self) -> usize

The number of items in the list.

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

The item at index. Panics if out of range.

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

The items, as a snapshot that stays unchanged if the list is modified (enumeration).

fn add_collection_changed( &self, handler: Rc<CollectionChangedHandler<T>>, ) -> u64

Subscribes to changes. Returns a token for remove_collection_changed.

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

Unsubscribes a handler.

impl<T> INotifyCollectionChanged for FerroList<T>

fn collection_changed(&self) -> &Event<CollectionChange>

The event raised when the collection changes.

impl<T> INotifyPropertyChanged for FerroList<T>

fn property_changed(&self) -> &Event<str>

The event raised when a property value changes.

fn as_notify_property_changing(&self) -> Option<&dyn INotifyPropertyChanging>

The object as INotifyPropertyChanging, when it also raises the event of a property that is about to change; None by default.

impl MarkupTyped for FerroList<Rc<dyn IAnimationSetter>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Rc<dyn IResourceProvider>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Ref<KeyBinding>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Rc<dyn SetterBase>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Rc<dyn IAnimation>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Rc<dyn BindingBase>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Point>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<String>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Ref<GradientStop>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Rc<dyn ITransition>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Ref<KeyFrame>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Ref<PathFigure>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Ref<PathSegment>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Ref<Drawing>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Ref<Transform>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Ref<Geometry>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<FontFeature>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl MarkupTyped for FerroList<Ref<TextDecoration>>

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl<T> PartialEq for FerroList<T>

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

Equality operator ==.

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

Inequality operator !=.

impl<T: 'static> WeakEventSender for FerroList<T>

type Weak = WeakFerroList<T>

The weak form of the handle.

fn downgrade_sender(&self) -> WeakFerroList<T>

fn upgrade_sender(weak: &WeakFerroList<T>) -> Option<Self>

fn sender_address(&self) -> usize

The address of the object the handle refers to.