Class RadTreeMapElement
Inheritance
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll
Syntax
public class RadTreeMapElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IImageElement, ITextPrimitive, ITextProvider, IDataItemSource
Constructors
RadTreeMapElement()
Declaration
public RadTreeMapElement()
Fields
GroupBackColorProperty
GroupBorderColorProperty
GroupHeaderHeightProperty
HoveredItemBackColorProperty
HoveredItemBorderColorProperty
HoveredItemBorderWidthProperty
SelectedItemBackColorProperty
SelectedItemBorderColorProperty
SelectedItemBorderWidthProperty
Properties
Algorithm
Gets or sets the tree map algorithm.
Declaration
public TreeMapAlgorithm Algorithm { get; set; }
Property Value
AllowHotTracking
Gets or sets a value indicating whether the hot tracking behavior is enabled.
Declaration
public bool AllowHotTracking { get; set; }
Property Value
System.
|
AllowSelection
Gets or sets a value indicating whether the selection is enabled.
Declaration
public bool AllowSelection { get; set; }
Property Value
System.
|
Colorizer
Gets or sets the tree map items colorizer.
Declaration
public BaseColorizer Colorizer { get; set; }
Property Value
DataSource
Gets or sets the data source.
Declaration
public object DataSource { get; set; }
Property Value
System.
|
DataView
Gets the DataView collection.
Declaration
public RadCollectionView<TreeMapDataItem> DataView { get; }
Property Value
DisplayMember
Gets or sets the display member.
Declaration
public string DisplayMember { get; set; }
Property Value
System.
|
EnableGrouping
Gets or sets a value indicating whether the grouping is enabled.
Declaration
public bool EnableGrouping { get; set; }
Property Value
System.
|
Font
Gets or sets the font. Font type defines a particular format for text, including font face, size, and style attributes.
Declaration
[RadPropertyDefaultValue("Font", typeof(VisualElement))]
public override Font Font { get; set; }
Property Value
System.
|
Overrides
GroupBackColor
Gets or sets the group background color.
Declaration
public Color GroupBackColor { get; set; }
Property Value
System.
|
GroupBorderColor
Gets or sets the group border color.
Declaration
public Color GroupBorderColor { get; set; }
Property Value
System.
|
GroupDescriptors
Gets a collection of Group
Declaration
public GroupDescriptorCollection GroupDescriptors { get; }
Property Value
GroupHeaderHeight
Gets or sets the header height of the groups.
Declaration
public int GroupHeaderHeight { get; set; }
Property Value
System.
|
Groups
Gets a collection containing the groups of the RadTreeMap.
Declaration
public TreeMapDataItemGroupCollection Groups { get; }
Property Value
GroupTextAlignment
Gets or sets the text alignment of the groups.
Declaration
public ContentAlignment GroupTextAlignment { get; set; }
Property Value
System.
|
HasGroups
Gets a value indicating, whether the grouping functionality is enabled and groups are added.
Declaration
public bool HasGroups { get; }
Property Value
System.
|
HoveredGroup
Gets the hovered group.
Declaration
public TreeMapDataItemGroup HoveredGroup { get; protected set; }
Property Value
HoveredItem
Gets the hovered item.
Declaration
public TreeMapDataItem HoveredItem { get; protected set; }
Property Value
HoveredItemBackColor
Gets or sets the hovered item background color.
Declaration
public Color HoveredItemBackColor { get; set; }
Property Value
System.
|
HoveredItemBorderColor
Gets or sets the hovered item border color.
Declaration
public Color HoveredItemBorderColor { get; set; }
Property Value
System.
|
HoveredItemBorderWidth
Gets or sets the hovered item border width.
Declaration
public int HoveredItemBorderWidth { get; set; }
Property Value
System.
|
Items
Gets a collection of Tree
Declaration
public TreeMapDataItemCollection Items { get; }
Property Value
ItemTextAlignment
Gets or sets the text alignment of the items.
Declaration
public ContentAlignment ItemTextAlignment { get; set; }
Property Value
System.
|
LegendElement
Gets the legend element.
Declaration
public TreeMapLegendElement LegendElement { get; }
Property Value
LegendOrientation
Gets or sets the orientation of the legend items.
Declaration
public Orientation LegendOrientation { get; set; }
Property Value
System.
|
LegendPosition
Gets or sets the position of the Legend
Declaration
public RadPosition LegendPosition { get; set; }
Property Value
LegendStack
Gets the legend stack.
Declaration
public StackLayoutElement LegendStack { get; }
Property Value
LegendTitle
Gets or sets the legend title.
Declaration
public string LegendTitle { get; set; }
Property Value
System.
|
ListSource
Gets the source of the items.
Declaration
public TreeMapListSource ListSource { get; }
Property Value
ScreenTip
Use the Screen
Declaration
public override RadScreenTipElement ScreenTip { get; set; }
Property Value
Overrides
ScreenTipElement
Gets or sets the screen tip element.
Declaration
public virtual RadOffice2007ScreenTipElement ScreenTipElement { get; set; }
Property Value
SelectedGroup
Gets or sets the selected group.
Declaration
public TreeMapDataItemGroup SelectedGroup { get; set; }
Property Value
SelectedItem
Gets or sets the selected item.
Declaration
public TreeMapDataItem SelectedItem { get; set; }
Property Value
SelectedItemBackColor
Gets or sets the selected item background color.
Declaration
public Color SelectedItemBackColor { get; set; }
Property Value
System.
|
SelectedItemBorderColor
Gets or sets the selected item border color.
Declaration
public Color SelectedItemBorderColor { get; set; }
Property Value
System.
|
SelectedItemBorderWidth
Gets or sets the border width of selected item.
Declaration
public int SelectedItemBorderWidth { get; set; }
Property Value
System.
|
ShowLegend
Gets or sets a value indicating whether legend is displayed.
Declaration
public bool ShowLegend { get; set; }
Property Value
System.
|
Title
Gets or sets the tree map title.
Declaration
public string Title { get; set; }
Property Value
System.
|
TitleElement
Gets the title element.
Declaration
public TreeMapTitleElement TitleElement { get; }
Property Value
TitleStack
Gets the title stack.
Declaration
public StackLayoutElement TitleStack { get; }
Property Value
ToolTip
ToolTipDisplayMode
Gets or sets a value indicating how to display tool tips.
Declaration
public ToolTipDisplayMode ToolTipDisplayMode { get; set; }
Property Value
ValueMember
Gets or sets the value member.
Declaration
public string ValueMember { get; set; }
Property Value
System.
|
WrapItemText
Gets or sets a value indicating whether to wrap the text of the items.
Declaration
public bool WrapItemText { get; set; }
Property Value
System.
|
Methods
AddStylePropertySetting(IPropertySetting)
Declaration
protected override ValueUpdateResult AddStylePropertySetting(IPropertySetting setting)
Parameters
IProperty
|
Returns
Overrides
ArrangeOverride(SizeF)
Declaration
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters
System.
|
Returns
System.
|
Overrides
ColorizeItems()
The colorizer passes through all items ad sets the corresponding background and foreground colors.
Declaration
public virtual void ColorizeItems()
CreateBindingContext()
Creates the binding context.
Declaration
protected virtual BindingContext CreateBindingContext()
Returns
System.
|
CreateChildElements()
Declaration
protected override void CreateChildElements()
Overrides
CreateDefaultAlgorithm()
Creates the default tree map algorithm.
Declaration
protected virtual TreeMapAlgorithm CreateDefaultAlgorithm()
Returns
CreateDefaultColorizer()
Creates the default tree map colorizer.
Declaration
protected virtual BaseColorizer CreateDefaultColorizer()
Returns
CreateLegendElement()
Declaration
protected virtual TreeMapLegendElement CreateLegendElement()
Returns
CreateLegendStack()
CreateListSource()
Creates the list source.
Declaration
protected virtual TreeMapListSource CreateListSource()
Returns
CreateScreenTipElement()
Declaration
protected virtual RadOffice2007ScreenTipElement CreateScreenTipElement()
Returns
CreateTitleElement()
CreateTitleStack()
CreateToolTip()
DisposeManagedResources()
Declaration
protected override void DisposeManagedResources()
Overrides
EvaluateAlgorithm()
Evaluates the algorithm. When the algorithm passes, each item will have updated Bounds property.
Declaration
public virtual void EvaluateAlgorithm()
FindGroup(Point)
Declaration
protected virtual TreeMapDataItemGroup FindGroup(Point location)
Parameters
System.
|
Returns
FindGroup(Point, TreeMapDataItemGroup, IEnumerable<TreeMapDataItemGroup>)
Declaration
protected virtual TreeMapDataItemGroup FindGroup(Point location, TreeMapDataItemGroup parent, IEnumerable<TreeMapDataItemGroup> groups)
Parameters
System.
|
Tree
|
System.
|
Returns
GetAlgorithmRectangle()
Declaration
protected virtual Rectangle GetAlgorithmRectangle()
Returns
System.
|
GetItemAndGroup(Point, out TreeMapDataItem, out TreeMapDataItemGroup)
Declaration
protected virtual bool GetItemAndGroup(Point location, out TreeMapDataItem item, out TreeMapDataItemGroup group)
Parameters
System.
|
Tree
|
Tree
|
Returns
System.
|
InitializeFields()
Declaration
protected override void InitializeFields()
Overrides
InitializeTreeMap()
Initialized the items.
Declaration
public virtual void InitializeTreeMap()
ManageToolTip(Point, TreeMapDataItem, TreeMapDataItemGroup)
Declaration
protected virtual void ManageToolTip(Point location, TreeMapDataItem item, TreeMapDataItemGroup group)
Parameters
System.
|
Tree
|
Tree
|
MeasureOverride(SizeF)
Declaration
protected override SizeF MeasureOverride(SizeF availableSize)
Parameters
System.
|
Returns
System.
|
Overrides
NewItem()
Create new row item.
Declaration
public IDataItem NewItem()
Returns
Implements
OnAlgorithmEvaluated()
OnBoundsChanged(RadPropertyChangedEventArgs)
Declaration
protected override void OnBoundsChanged(RadPropertyChangedEventArgs e)
Parameters
Overrides
OnDataItemCreating(TreeMapItemCreatingEventArgs)
Fires the Item
Declaration
protected virtual void OnDataItemCreating(TreeMapItemCreatingEventArgs args)
Parameters
Tree The event arguments. |
OnGroupPainted(TreeMapGroupPaintedEventArgs)
Fires the Group
Declaration
protected virtual void OnGroupPainted(TreeMapGroupPaintedEventArgs args)
Parameters
Tree The event arguments. |
OnGroupPainting(TreeMapGroupPaintingEventArgs)
Fires the Group
Declaration
protected virtual void OnGroupPainting(TreeMapGroupPaintingEventArgs args)
Parameters
Tree The event arguments. |
OnHoveredGroupChanged(TreeMapGroupChangedEventArgs)
Fires the Hovered
Declaration
protected virtual void OnHoveredGroupChanged(TreeMapGroupChangedEventArgs args)
Parameters
Tree The event arguments. |
OnHoveredItemChanged(TreeMapItemChangedEventArgs)
Declaration
protected virtual void OnHoveredItemChanged(TreeMapItemChangedEventArgs args)
Parameters
OnItemDataBound(TreeMapItemEventArgs)
Fires the Item
Declaration
protected virtual void OnItemDataBound(TreeMapItemEventArgs args)
Parameters
Tree The event arguments. |
OnItemPainted(TreeMapItemPaintedEventArgs)
Fires the Item
Declaration
protected virtual void OnItemPainted(TreeMapItemPaintedEventArgs args)
Parameters
Tree The event arguments. |
OnItemPainting(TreeMapItemPaintingEventArgs)
Fires the Item
Declaration
protected virtual void OnItemPainting(TreeMapItemPaintingEventArgs args)
Parameters
Tree The event arguments. |
OnLoaded()
OnMouseDown(MouseEventArgs)
Declaration
protected override void OnMouseDown(MouseEventArgs e)
Parameters
System.
|
Overrides
OnMouseLeave(EventArgs)
Declaration
protected override void OnMouseLeave(EventArgs e)
Parameters
System.
|
Overrides
OnMouseMove(MouseEventArgs)
Declaration
protected override void OnMouseMove(MouseEventArgs e)
Parameters
System.
|
Overrides
OnPropertyChanged(RadPropertyChangedEventArgs)
Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
Overrides
OnScreenTipShowing(TreeMapScreenTipEventArgs)
Fires the Screen
Declaration
protected virtual void OnScreenTipShowing(TreeMapScreenTipEventArgs args)
Parameters
Tree The event arguments. |
OnSelectedGroupChanged(TreeMapGroupChangedEventArgs)
Fires the Selected
Declaration
protected virtual void OnSelectedGroupChanged(TreeMapGroupChangedEventArgs args)
Parameters
Tree The event arguments. |
OnSelectedGroupChanging(TreeMapGroupChangingEventArgs)
Fires the Selected
Declaration
protected virtual void OnSelectedGroupChanging(TreeMapGroupChangingEventArgs args)
Parameters
Tree The event arguments. |
OnSelectedItemChanged(TreeMapItemChangedEventArgs)
Fires the Selected
Declaration
protected virtual void OnSelectedItemChanged(TreeMapItemChangedEventArgs args)
Parameters
Tree The event arguments. |
OnSelectedItemChanging(TreeMapItemChangingEventArgs)
Fires the Selected
Declaration
protected virtual void OnSelectedItemChanging(TreeMapItemChangingEventArgs args)
Parameters
Tree The event arguments. |
OnShowScreenTip(ComponentInputBehavior)
Declaration
protected override bool OnShowScreenTip(ComponentInputBehavior inputBehavior)
Parameters
Component
|
Returns
System.
|
Overrides
OnToolTipShowing(TreeMapToolTipEventArgs)
Fires the Tool
Declaration
protected virtual void OnToolTipShowing(TreeMapToolTipEventArgs args)
Parameters
Tree The event arguments. |
PaintContent(IGraphics)
Declaration
protected override void PaintContent(IGraphics graphics)
Parameters
IGraphics
graphics
|
Overrides
PaintGroup(IGraphics, TreeMapDataItemGroup)
Declaration
public virtual void PaintGroup(IGraphics graphics, TreeMapDataItemGroup group)
Parameters
IGraphics
graphics
|
Tree
|
PaintGroupBorder(TreeMapDataItemGroup, IGraphics, RectangleF, RectangleF, Color)
Declaration
protected virtual void PaintGroupBorder(TreeMapDataItemGroup group, IGraphics graphics, RectangleF rectangle, RectangleF headerRect, Color borderColor)
Parameters
Tree
|
IGraphics
graphics
|
System.
|
System.
|
System.
|
PaintGroupContent(TreeMapDataItemGroup, IGraphics)
Declaration
protected virtual void PaintGroupContent(TreeMapDataItemGroup group, IGraphics graphics)
Parameters
Tree
|
IGraphics
graphics
|
PaintGroupHeaderBackground(TreeMapDataItemGroup, IGraphics, RectangleF, Color)
Declaration
protected virtual void PaintGroupHeaderBackground(TreeMapDataItemGroup group, IGraphics graphics, RectangleF headerRect, Color backColor)
Parameters
Tree
|
IGraphics
graphics
|
System.
|
System.
|
PaintGroupHeaderText(TreeMapDataItemGroup, IGraphics, RectangleF, String, Color, Font, ContentAlignment)
Declaration
protected virtual void PaintGroupHeaderText(TreeMapDataItemGroup group, IGraphics graphics, RectangleF headerRect, string groupText, Color foreColor, Font font, ContentAlignment textAlignment)
Parameters
Tree
|
IGraphics
graphics
|
System.
|
System.
|
System.
|
System.
|
System.
|
PaintGroups(IGraphics, IEnumerable<TreeMapDataItemGroup>)
Declaration
public virtual void PaintGroups(IGraphics graphics, IEnumerable<TreeMapDataItemGroup> groups)
Parameters
IGraphics
graphics
|
System.
|
PaintItem(IGraphics, TreeMapDataItem)
Declaration
public virtual void PaintItem(IGraphics graphics, TreeMapDataItem dataItem)
Parameters
IGraphics
graphics
|
Tree
|
PaintItemBackground(TreeMapDataItem, IGraphics, RectangleF, Color)
Declaration
protected virtual void PaintItemBackground(TreeMapDataItem dataItem, IGraphics graphics, RectangleF rectangle, Color backColor)
Parameters
Tree
|
IGraphics
graphics
|
System.
|
System.
|
PaintItemBorder(TreeMapDataItem, IGraphics, RectangleF, Color, Int32)
Declaration
protected virtual void PaintItemBorder(TreeMapDataItem dataItem, IGraphics graphics, RectangleF rectangle, Color borderColor, int borderWidth)
Parameters
Tree
|
IGraphics
graphics
|
System.
|
System.
|
System.
|
PaintItems(IGraphics, IEnumerable<TreeMapDataItem>)
Declaration
public virtual void PaintItems(IGraphics graphics, IEnumerable<TreeMapDataItem> items)
Parameters
IGraphics
graphics
|
System.
|
PaintItemText(TreeMapDataItem, IGraphics, RectangleF, String, Color, Font, ContentAlignment)
Declaration
protected virtual void PaintItemText(TreeMapDataItem dataItem, IGraphics graphics, RectangleF rectangle, string text, Color foreColor, Font font, ContentAlignment textAlignment)
Parameters
Tree
|
IGraphics
graphics
|
System.
|
System.
|
System.
|
System.
|
System.
|
ShouldArrangeChild(RadElement)
Declaration
protected override bool ShouldArrangeChild(RadElement child)
Parameters
Rad
|
Returns
System.
|
Overrides
ShouldMeasureChild(RadElement)
Declaration
protected override bool ShouldMeasureChild(RadElement child)
Parameters
Rad
|
Returns
System.
|
Overrides
UpdateLegend()
Declaration
protected virtual void UpdateLegend()
UpdateLegendVisibility()
Declaration
protected virtual void UpdateLegendVisibility()
Events
AlgorithmEvaluated
Declaration
public event EventHandler AlgorithmEvaluated
Event Type
System.
|
GroupPainted
Occurs when a group and its items have been painted.
Declaration
public event TreeMapGroupPaintedEventHandler GroupPainted
Event Type
GroupPainting
Occurs when an group is about to be painted.
Declaration
public event TreeMapGroupPaitingEventHandler GroupPainting
Event Type
HoveredGroupChanged
Occurs when the hovered group has changed.
Declaration
public event TreeMapGroupChangedEventHandler HoveredGroupChanged
Event Type
HoveredItemChanged
Occurs when the hovered item has changed.
Declaration
public event TreeMapItemChangedEventHandler HoveredItemChanged
Event Type
ItemCreating
Occurs when a Tree
Declaration
public event TreeMapItemCreatingEventHandler ItemCreating
Event Type
ItemDataBound
Occurs when a data-bound item is being attached to a Tree
Declaration
public event TreeMapItemEventHandler ItemDataBound
Event Type
ItemPainted
Occurs when an item has been painted.
Declaration
public event TreeMapItemPaitedEventHandler ItemPainted
Event Type
ItemPainting
Occurs when an item is about to be painted.
Declaration
public event TreeMapItemPaitingEventHandler ItemPainting
Event Type
ScreenTipShowing
Occurs when the screen tip is about to be shown. Cancellable.
Declaration
public event TreeMapScreenTipEventHandler ScreenTipShowing
Event Type
SelectedGroupChanged
Occurs when the selected group has changed.
Declaration
public event TreeMapGroupChangedEventHandler SelectedGroupChanged
Event Type
SelectedGroupChanging
Occurs when the selected group is about to be changed. Cancellable.
Declaration
public event TreeMapGroupChangingEventHandler SelectedGroupChanging
Event Type
SelectedItemChanged
Occurs when the selected item has changed.
Declaration
public event TreeMapItemChangedEventHandler SelectedItemChanged
Event Type
SelectedItemChanging
Occurs when the selected item is about to be changed. Cancellable.
Declaration
public event TreeMapItemChangingEventHandler SelectedItemChanging
Event Type
ToolTipShowing
Occurs when the tool tip is about to be shown. Cancellable.
Declaration
public event TreeMapToolTipEventHandler ToolTipShowing
Event Type
Explicit Interface Implementations
IDataItemSource.BindingComplete()
IDataItemSource.BindingContext
Declaration
BindingContext IDataItemSource.BindingContext { get; }
Returns
System.
|
Implements
IDataItemSource.BindingContextChanged
Declaration
event EventHandler IDataItemSource.BindingContextChanged
Returns
System.
|
Implements
IDataItemSource.Initialize()
Initializes IDataItemSource.
Declaration
void IDataItemSource.Initialize()
Implements
IDataItemSource.MetadataChanged(PropertyDescriptor)
Declaration
void IDataItemSource.MetadataChanged(PropertyDescriptor pd)
Parameters
System.
|