TreeMapDataItem
Represents one item whose value and text are used to calculate and label a tree map region.
Definition
Namespace:Telerik.WinControls.UI.TreeMap
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TypeConverter(typeof(TreeMapDataItemTypeConverter))]
public class TreeMapDataItem : IDataItem, INotifyPropertyChanged, IDisposable
Inheritance: objectTreeMapDataItem
Derived Classes:
Implements:
Constructors
Initializes an item whose text and value can be set later or obtained from bound data.
public TreeMapDataItem()
Properties
Gets the value used by the tree map algorithm.
[Browsable(false)]
public double? AlgorithmValue { get; }
Gets or sets the bounds of the item.
[Browsable(false)]
public RectangleF Bounds { get; set; }
Gets or sets the source object from which this item can obtain bound property values.
[Browsable(false)]
public object DataBoundItem { get; set; }
Implements:
Setting this property raises PropertyChanged. If the item belongs to a tree map with a non-null data source, the tree map also raises its ItemDataBound event.
Gets the number of bound properties exposed by the owning tree map's list source.
public int FieldCount { get; }
Implements:
Returns zero when the item is not attached to an initialized list source.
Gets or sets the group whose item list contains this item.
[Browsable(true)]
public virtual TreeMapDataItemGroup Group { get; set; }
Changing the group removes the item from its previous group and adds it to the new one.
Gets the tree map element that currently owns this item.
[Browsable(false)]
public RadTreeMapElement Owner { get; }
The element assigns ownership when it creates or adds the item and clears it when the item is removed.
Gets or sets the item style.
[Browsable(false)]
public TreeMapItemStyle Style { get; set; }
Gets or sets the tag.
[Bindable(true)]
[TypeConverter(typeof(StringConverter))]
public object Tag { get; set; }
Gets or sets a bound property by its position in the owning list source's property list.
Methods
Provides the disposal hook for IDisposable; this implementation releases no resources.
public virtual void Dispose()
Implements:
Resolves the source value used by Value when no explicit value is set.
protected virtual object GetBoundValue()
The bound value member when configured; otherwise the display member, or the complete bound item when neither member is configured or the selected member cannot be read.
Gets the display-member name from the group, or from the owning tree map when the item is not grouped.
protected virtual string GetDisplayMember()
The configured display-member name, or an empty string when there is no owner or group.
Retrieves a named value from the bound item, falling back to the bound item itself if the property lookup fails.
protected object GetValue(string propertyName)
The bound property to retrieve.
Returns:The property's value, or the complete bound item when lookup raises ArgumentException.
Gets the value-member name from the group, or from the owning tree map when the item is not grouped.
protected virtual string GetValueMember()
The configured value-member name, or an empty string when there is no owner or group.
Raises PropertyChanged and keeps group membership valid when the owner changes.
protected virtual void OnNotifyPropertyChanged(PropertyChangedEventArgs args)
The property change details.
If the item is moved to an owner different from its group's owner, its Group is cleared.
Raises PropertyChanged for the named property.
protected virtual void OnNotifyPropertyChanged(string propertyName)
The name of the property that changed.
Assigns the source object used for data-bound values and notifies the owning tree map when applicable.
Events
Occurs when an item property changes, including when the item is attached to or removed from an owner.
public event PropertyChangedEventHandler PropertyChanged
Implements: