Provides access to the data items displayed by a RadTreeMapElement.
The collection is backed by the tree map's list source. Items moved from another tree map are removed from their previous owner before being added here.
Definition
Namespace:Telerik.WinControls.UI.TreeMap
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class TreeMapDataItemCollection : IList, ICollection, IEnumerable, INotifyCollectionChanged
Inheritance: objectTreeMapDataItemCollection
Implements:
Constructors
Initializes a collection associated with the specified tree map element.
public TreeMapDataItemCollection(RadTreeMapElement owner)
The element whose item list this collection exposes.
Properties
Gets the number of items in the current collection view.
public int Count { get; }
Implements:
Gets whether this collection has a fixed size.
public bool IsFixedSize { get; }
Implements:
This property always returns false; it does not indicate whether the current data source allows programmatic edits.
Gets whether the underlying list source permits item changes.
public bool IsReadOnly { get; }
Implements:
Gets whether access to the underlying list source is synchronized.
public bool IsSynchronized { get; }
Implements:
This value is provided by the list source; this collection adds no synchronization.
Gets the synchronization object supplied by the underlying list source.
public object SyncRoot { get; }
Implements:
Gets or replaces the item at a position in the tree map's current collection view.
public TreeMapDataItem this[int index] { get; set; }
The zero-based position of the item.
Methods
Creates an item through the tree map's item-creation hook and adds it with the specified value.
public void Add(double value)
The numeric value used by the tree map layout algorithm.
The item is created through NewItem(), so the ItemCreating event can customize or replace it.
Creates an item through the tree map's item-creation hook and adds it with the specified text and value.
public void Add(string text, double value)
The item's explicit display text; a bound display value is used only when this is null.
valuedoubleThe numeric value used by the tree map layout algorithm.
The item is created through NewItem(), so the ItemCreating event can customize or replace it.
Adds an item, removing it from a different tree map first when necessary.
Adds the specified items while batching updates to the underlying list source.
public virtual void AddRange(params TreeMapDataItem[] TreeMapDataItems)
The items to add.
Begins a batch of changes to the underlying item list.
public void BeginUpdate()
Call EndUpdate() after the batch so the list source can resume its normal update processing.
Determines whether the collection contains the specified object when it is a tree map item.
public bool Contains(object value)
The object to locate.
Returns:true if value is a contained TreeMapDataItem; otherwise, false.
Implements:
Determines whether the current collection view contains the specified item.
public bool Contains(TreeMapDataItem item)
The item to locate.
Returns:Copies the items in the current collection view to an array, beginning at the specified array index.
public void CopyTo(TreeMapDataItem[] array, int arrayIndex)
The destination array.
arrayIndexintThe zero-based destination index at which copying begins.
Ends a batch of changes previously started by BeginUpdate().
public void EndUpdate()
Returns an enumerator over the items in the current collection view.
public IEnumerator<TreeMapDataItem> GetEnumerator()
IEnumerator<TreeMapDataItem>
An enumerator for the tree map's current item view.
Returns the position of an item in the tree map's current collection view.
public int IndexOf(TreeMapDataItem item)
The item to locate.
Returns:The item's zero-based position, or -1 if it is not in the collection view.
Inserts the specified object when it is a TreeMapDataItem.
Inserts an item at the specified position, removing it from a different tree map first when necessary.
public void Insert(int index, TreeMapDataItem item)
The zero-based position at which to insert the item.
itemTreeMapDataItemThe item to insert.
Exceptions: InvalidOperationExceptionThe underlying list source rejects the insertion, including when items are added programmatically while the tree map is data-bound.
Raises the CollectionChanged event.
protected virtual void OnCollectionChanged(NotifyCollectionChangedEventArgs args)
The change details supplied by the collection view.
Removes the specified object when it is a TreeMapDataItem.
public void Remove(object value)
The object to remove; objects of other types are ignored.
Implements:
Removes the specified item from the list source and clears its owner reference.
public bool Remove(TreeMapDataItem item)
The item to remove.
Returns:The item's Owner is cleared even when the list source reports that the item was not present.
Removes the item at the specified position.
public void RemoveAt(int index)
The zero-based position of the item to remove.
Implements:
Events
Occurs when the underlying collection view adds, removes, replaces, or resets items.
public event NotifyCollectionChangedEventHandler CollectionChanged
Implements: