RadTreeMapElement
Represents the core element of the RadTreeMap control that provides data visualization capabilities for hierarchical data through nested rectangles.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadTreeMapElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider, IDataItemSourceInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadTreeMapElement...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadTreeMapElement class.
public RadTreeMapElement()Fields
Identifies the GroupBackColor dependency property.
public static RadProperty GroupBackColorPropertyIdentifies the GroupBorderColor dependency property.
public static RadProperty GroupBorderColorPropertyIdentifies the GroupHeaderHeight dependency property.
public static RadProperty GroupHeaderHeightPropertyIdentifies the HoveredItemBackColor dependency property.
public static RadProperty HoveredItemBackColorPropertyIdentifies the HoveredItemBorderColor dependency property.
public static RadProperty HoveredItemBorderColorPropertyIdentifies the HoveredItemBorderWidth dependency property.
public static RadProperty HoveredItemBorderWidthPropertyIdentifies the SelectedItemBackColor dependency property.
public static RadProperty SelectedItemBackColorPropertyIdentifies the SelectedItemBorderColor dependency property.
public static RadProperty SelectedItemBorderColorPropertyIdentifies the SelectedItemBorderWidth dependency property.
public static RadProperty SelectedItemBorderWidthPropertyProperties
Gets or sets the algorithm used for calculating the layout and positioning of rectangles in the treemap.
[Browsable(false)]
public TreeMapAlgorithm Algorithm { get; set; }The algorithm determines how the available space is divided among the data items based on their values. If no algorithm is explicitly set, a default SquarifiedAlgorithm instance is created.
Gets or sets a value indicating whether hot tracking (hover effects) is enabled for treemap items.
public bool AllowHotTracking { get; set; }When hot tracking is disabled, the HoveredItem and HoveredGroup properties are set to null.
Gets or sets a value indicating whether selection of treemap items is enabled.
public bool AllowSelection { get; set; }When selection is disabled, the SelectedItem and SelectedGroup properties are set to null.
Gets or sets the colorizer used for applying colors to treemap items and groups.
[Browsable(false)]
public BaseColorizer Colorizer { get; set; }The colorizer determines the background and foreground colors for items and groups in the treemap. If no colorizer is explicitly set, a default PaletteColorizer instance is created.
Gets or sets the data source for the treemap visualization.
[Browsable(true)]
public object DataSource { get; set; }The DataSource can be any object that implements IList, IListSource, IBindingList, or IEnumerable. When set to null, both DisplayMember and ValueMember are reset to empty strings.
Gets the collection view that provides filtering, sorting, and grouping capabilities over the data source.
[Browsable(false)]
public RadCollectionView<TreeMapDataItem> DataView { get; }Gets or sets the name of the property that provides display text for each data item in the treemap.
[Browsable(true)]
[TypeConverter("System.Windows.Forms.Design.DataMemberFieldConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string DisplayMember { get; set; }The DisplayMember property specifies which property of the bound data objects contains the text that will be displayed on each rectangle in the treemap visualization.
Gets or sets a value indicating whether grouping functionality is enabled for the treemap.
public bool EnableGrouping { get; set; }When grouping is disabled, all items are displayed as individual rectangles without hierarchical organization. When enabled, items can be organized into groups based on the configured GroupDescriptors.
Gets or sets the font used for rendering text in the treemap elements.
public override Font Font { get; set; }Overrides:
The font property defines the typeface, size, and style attributes for text displayed on treemap items and groups. This property is inheritable through the element tree and cached for performance optimization.
Gets or sets the background color for group headers and areas.
public Color GroupBackColor { get; set; }This color is used to fill the background of group rectangles in the treemap visualization. The value is cached for performance during rendering operations.
Gets or sets the border color for group rectangles.
public Color GroupBorderColor { get; set; }This color is used to draw the borders around group rectangles in the treemap visualization. The value is cached for performance during rendering operations.
Gets a collection of GroupDescriptor objects that define grouping rules for the treemap data items.
[Browsable(true)]
public GroupDescriptorCollection GroupDescriptors { get; }Group descriptors are used to organize data items into hierarchical groups, which are then visualized as nested rectangles in the treemap. Each group can contain child groups and individual items.
Gets or sets the height of group headers in pixels.
public int GroupHeaderHeight { get; set; }This property determines the vertical space allocated for displaying group titles. The value is cached for performance during rendering operations.
Gets a collection of TreeMapDataItemGroup objects that represent groups in the treemap hierarchy.
[Browsable(true)]
public TreeMapDataItemGroupCollection Groups { get; }Groups are used to organize related data items and are visualized as larger rectangles containing nested rectangles for their child items or subgroups.
Gets or sets the text alignment for group headers.
public ContentAlignment GroupTextAlignment { get; set; }This property determines how group titles are positioned within group header areas.
Gets a value indicating whether the treemap has groups and grouping is enabled.
public bool HasGroups { get; }This property returns true only when both EnableGrouping is true and there are groups in the Groups collection.
Gets the currently hovered group, or null if no group is being hovered.
[Browsable(false)]
public TreeMapDataItemGroup HoveredGroup { get; protected set; }This property is automatically updated when the mouse moves over treemap groups, provided that AllowHotTracking is enabled.
Gets the currently hovered data item, or null if no item is being hovered.
[Browsable(false)]
public TreeMapDataItem HoveredItem { get; protected set; }This property is automatically updated when the mouse moves over treemap items, provided that AllowHotTracking is enabled.
Gets or sets the background color for hovered items.
public Color HoveredItemBackColor { get; set; }When an item is hovered and this color is not empty, it overrides the item's default background color. The value is cached for performance during rendering operations.
Gets or sets the border color for hovered items.
public Color HoveredItemBorderColor { get; set; }This color is used to draw the border around items when they are being hovered by the mouse. The value is cached for performance during rendering operations.
Gets or sets the border width in pixels for hovered items.
public int HoveredItemBorderWidth { get; set; }This value determines the thickness of the border drawn around items when they are being hovered. The value is cached for performance during rendering operations.
Gets a collection of TreeMapDataItem objects that represent individual items in the treemap.
[Browsable(true)]
public TreeMapDataItemCollection Items { get; }This collection contains all the data items that will be visualized as rectangles in the treemap. Each item has properties for value, text, style, and calculated bounds.
Gets or sets the text alignment for individual treemap items.
public ContentAlignment ItemTextAlignment { get; set; }This property determines how text is positioned within each item's rectangle, such as top-left, center, bottom-right, etc.
Gets the legend element that displays color mappings and group information.
public TreeMapLegendElement LegendElement { get; }Gets or sets the orientation of the legend items (horizontal or vertical layout).
public Orientation LegendOrientation { get; set; }Gets or sets the position of the legend relative to the treemap visualization area.
public RadPosition LegendPosition { get; set; }The legend can be positioned at the top, bottom, left, right, or hidden by setting to None.
Gets the stack layout element that contains the legend area.
public StackLayoutElement LegendStack { get; }Gets or sets the title text displayed in the legend.
public string LegendTitle { get; set; }Gets the source object that manages data binding and collection operations.
[Browsable(false)]
public TreeMapListSource ListSource { get; }Gets or sets the screen tip element used for displaying Office-style screen tips.
public virtual RadOffice2007ScreenTipElement ScreenTipElement { get; set; }If no screen tip element is explicitly set, a default RadOffice2007ScreenTipElement instance is created when first accessed.
Gets or sets the currently selected group in the treemap.
[Browsable(false)]
public TreeMapDataItemGroup SelectedGroup { get; set; }Setting this property triggers the SelectedGroupChanging event, which can be cancelled. If not cancelled, the selection is changed and the SelectedGroupChanged event is raised.
Gets or sets the currently selected item in the treemap.
[Browsable(false)]
public TreeMapDataItem SelectedItem { get; set; }Setting this property triggers the SelectedItemChanging event, which can be cancelled. If not cancelled, the selection is changed and the SelectedItemChanged event is raised.
Gets or sets the background color for selected items.
public Color SelectedItemBackColor { get; set; }When an item is selected and this color is not empty, it overrides the item's default background color. The value is cached for performance during rendering operations.
Gets or sets the border color for selected items.
public Color SelectedItemBorderColor { get; set; }This color is used to draw the border around items when they are selected. The value is cached for performance during rendering operations.
Gets or sets the border width in pixels for selected items.
public int SelectedItemBorderWidth { get; set; }This value determines the thickness of the border drawn around items when they are selected. The value is cached for performance during rendering operations.
Gets or sets a value indicating whether the legend is displayed for the treemap.
public bool ShowLegend { get; set; }The legend shows color mappings for different groups or categories in the treemap visualization.
Gets or sets the title text displayed at the top of the treemap.
public string Title { get; set; }Gets the title element that displays the treemap title.
public TreeMapTitleElement TitleElement { get; }Gets the stack layout element that contains the title area.
public StackLayoutElement TitleStack { get; }Gets or sets the tooltip control used for displaying standard tooltips.
public RadToolTip ToolTip { get; set; }If no tooltip is explicitly set, a default RadToolTip instance is created when first accessed.
Gets or sets the mode for displaying tooltips when hovering over treemap elements.
public ToolTipDisplayMode ToolTipDisplayMode { get; set; }Options include None (no tooltips), ToolTip (standard tooltips), or ScreenTip (Office-style screen tips).
Gets or sets the value member.
[Browsable(true)]
public string ValueMember { get; set; }The ValueMember property specifies which property of the bound data objects contains the numeric values that determine the size of each rectangle in the treemap visualization.
Gets or sets a value indicating whether text in treemap items should wrap to multiple lines.
public bool WrapItemText { get; set; }When enabled, long text that doesn't fit within an item's rectangle will wrap to the next line. When disabled, text is displayed on a single line and may be truncated with ellipsis.
Methods
Adds a style property setting and clears the cached values to ensure they are refreshed.
protected override ValueUpdateResult AddStylePropertySetting(IPropertySetting setting)The property setting to add.
Returns:The result of the value update operation.
Overrides:
Arranges the treemap element and positions the title and legend stacks according to the legend position.
protected override SizeF ArrangeOverride(SizeF finalSize)The final size allocated for the element.
Returns:The actual size used by the element.
Overrides:
This method positions the legend and title stacks to avoid overlapping with the main treemap content area. The legend has priority in positioning, and the title area is adjusted accordingly.
Applies colors to all treemap items and groups using the configured Colorizer.
public virtual void ColorizeItems()This method delegates to the colorizer to set background and foreground colors for items or groups, depending on whether grouping is enabled. It also synchronizes the legend display.
Creates the binding context used for data binding operations.
Creates the child elements including title stack, title element, legend stack, and legend element.
protected override void CreateChildElements()Overrides:
Creates the default tree map algorithm used for calculating rectangle layouts.
protected virtual TreeMapAlgorithm CreateDefaultAlgorithm()A new SquarifiedAlgorithm instance as the default algorithm.
Creates the default colorizer used for applying colors to treemap items and groups.
protected virtual BaseColorizer CreateDefaultColorizer()A new PaletteColorizer instance as the default colorizer.
Creates a new TreeMapLegendElement for displaying the treemap legend.
protected virtual TreeMapLegendElement CreateLegendElement()A new TreeMapLegendElement instance associated with this treemap element.
Creates a new StackLayoutElement for organizing the legend area.
protected virtual StackLayoutElement CreateLegendStack()A new StackLayoutElement instance.
Creates the list source that manages the data binding and collection view.
protected virtual TreeMapListSource CreateListSource()A new TreeMapListSource instance associated with this treemap element.
Creates a new RadOffice2007ScreenTipElement instance for displaying screen tips.
protected virtual RadOffice2007ScreenTipElement CreateScreenTipElement()A new RadOffice2007ScreenTipElement instance with empty text labels.
Creates a new TreeMapTitleElement for displaying the treemap title.
protected virtual TreeMapTitleElement CreateTitleElement()A new TreeMapTitleElement instance.
Creates a new StackLayoutElement for organizing the title area.
protected virtual StackLayoutElement CreateTitleStack()A new StackLayoutElement instance.
Creates a new RadToolTip instance for displaying tooltips.
Releases the unmanaged resources used by the RadTreeMapElement and optionally releases the managed resources.
protected override void DisposeManagedResources()Overrides:
Evaluates the treemap layout algorithm and updates the bounds of all items and groups.
public virtual void EvaluateAlgorithm()This method calculates the size and position of each rectangle in the treemap based on the item values and the configured algorithm. It handles both grouped and ungrouped scenarios and applies colorization after layout calculation.
Recursively searches for groups at the specified location within a collection of groups.
protected virtual TreeMapDataItemGroup FindGroup(Point location, TreeMapDataItemGroup parent, IEnumerable<TreeMapDataItemGroup> groups)The point to search for groups.
parentTreeMapDataItemGroupThe parent group being searched (can be null for root level).
groupsIEnumerable<TreeMapDataItemGroup>The collection of groups to search within.
Returns:The most specific TreeMapDataItemGroup at the location, or null if none found.
Finds the topmost group at the specified location within the treemap.
protected virtual TreeMapDataItemGroup FindGroup(Point location)The point to search for groups.
Returns:The TreeMapDataItemGroup at the specified location, or null if no group is found.
This method performs hierarchical hit testing to find the most specific group at the given location. If groups are nested, it returns the innermost group that contains the point.
Calculates the rectangle area available for the treemap algorithm, excluding title, legend, borders, and padding.
protected virtual Rectangle GetAlgorithmRectangle()A Rectangle representing the area where treemap items should be positioned.
This method accounts for the title height, legend position and size, element borders, and padding to determine the actual space available for rendering treemap rectangles.
Determines the item and group at the specified location.
protected virtual bool GetItemAndGroup(Point location, out TreeMapDataItem item, out TreeMapDataItemGroup group)The point to perform hit testing.
itemTreeMapDataItemWhen this method returns, contains the item at the location or null.
groupTreeMapDataItemGroupWhen this method returns, contains the group at the location or null.
Returns:True if an item or group was found at the location; otherwise, false.
This method first searches for groups, then searches for items within the found group or at the root level. It provides the foundation for hover detection, selection, and tooltip functionality.
Initializes the fields and default property values for the RadTreeMapElement.
protected override void InitializeFields()Overrides:
Initializes the treemap by evaluating the layout algorithm and applying colors.
public virtual void InitializeTreeMap()This method should be called after setting up data sources, algorithms, or other configuration to ensure the treemap is properly rendered.
Manages tooltip display for the specified item or group at the given location.
protected virtual void ManageToolTip(Point location, TreeMapDataItem item, TreeMapDataItemGroup group)The mouse location where the tooltip should be displayed.
itemTreeMapDataItemThe item to show tooltip for, or null.
groupTreeMapDataItemGroupThe group to show tooltip for, or null.
This method handles both screen tip and standard tooltip modes, showing appropriate content based on the hovered item or group and the configured ToolTipDisplayMode.
Measures the treemap element and its child elements to determine the desired size.
protected override SizeF MeasureOverride(SizeF availableSize)The maximum size available for the element.
Returns:The desired size of the element, which is the full available size.
Overrides:
This method measures the legend stack first, then calculates the remaining space for the title stack. The legend position affects how the available space is divided between title and legend areas.
Creates a new data item instance for use in the treemap.
public IDataItem NewItem()A new TreeMapDataItem instance associated with this treemap element.
Implements:
This method creates a new item and raises the ItemCreating event to allow customization of the item creation process.
Raises the AlgorithmEvaluated event.
protected virtual void OnAlgorithmEvaluated()Handles bounds changes by reevaluating the algorithm and invalidating the display.
protected override void OnBoundsChanged(RadPropertyChangedEventArgs e)The bounds change event arguments.
Overrides:
When the element size changes, the treemap layout needs to be recalculated to fit the new dimensions.
Raises the ItemCreating event.
protected virtual void OnDataItemCreating(TreeMapItemCreatingEventArgs args)The event arguments containing the item being created.
Raises the GroupPainted event.
protected virtual void OnGroupPainted(TreeMapGroupPaintedEventArgs args)The event arguments containing information about the painted group.
Raises the GroupPainting event.
protected virtual void OnGroupPainting(TreeMapGroupPaintingEventArgs args)The event arguments containing painting information for the group.
Raises the HoveredGroupChanged event.
protected virtual void OnHoveredGroupChanged(TreeMapGroupChangedEventArgs args)The event arguments containing the old and new hovered groups.
Raises the HoveredItemChanged event.
protected virtual void OnHoveredItemChanged(TreeMapItemChangedEventArgs args)The event arguments containing the old and new hovered items.
Raises the ItemDataBound event.
protected virtual void OnItemDataBound(TreeMapItemEventArgs args)The event arguments containing the bound item.
Raises the ItemPainted event.
protected virtual void OnItemPainted(TreeMapItemPaintedEventArgs args)The event arguments containing information about the painted item.
Raises the ItemPainting event.
protected virtual void OnItemPainting(TreeMapItemPaintingEventArgs args)The event arguments containing painting information for the item.
Handles the Loaded event by updating the legend display.
protected override void OnLoaded()Overrides:
This method ensures that the legend is properly initialized and displayed when the element is loaded.
Handles the mouse down event for item and group selection.
protected override void OnMouseDown(MouseEventArgs e)The mouse event arguments.
Overrides:
Handles the mouse leave event by clearing hover states and hiding tooltips.
protected override void OnMouseLeave(EventArgs e)The event arguments.
Overrides:
Handles the mouse move event for hover tracking and tooltip management.
protected override void OnMouseMove(MouseEventArgs e)The mouse event arguments.
Overrides:
Handles property change notifications and clears cached values when relevant properties change.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)The property change event arguments.
Overrides:
This method clears specific cached values when their corresponding properties change, ensuring that the cached values are refreshed on the next access.
Raises the ScreenTipShowing event.
protected virtual void OnScreenTipShowing(TreeMapScreenTipEventArgs args)The event arguments containing screen tip information and cancellation capability.
Raises the SelectedGroupChanged event.
protected virtual void OnSelectedGroupChanged(TreeMapGroupChangedEventArgs args)The event arguments containing the old and new selected groups.
Raises the SelectedGroupChanging event.
protected virtual void OnSelectedGroupChanging(TreeMapGroupChangingEventArgs args)The event arguments containing the old and new selected groups and cancellation capability.
Raises the SelectedItemChanged event.
protected virtual void OnSelectedItemChanged(TreeMapItemChangedEventArgs args)The event arguments containing the old and new selected items.
Raises the SelectedItemChanging event.
protected virtual void OnSelectedItemChanging(TreeMapItemChangingEventArgs args)The event arguments containing the old and new selected items and cancellation capability.
Overrides the default screen tip behavior to prevent automatic screen tip display.
protected override bool OnShowScreenTip(ComponentInputBehavior inputBehavior)The input behavior requesting the screen tip.
Returns:False to prevent the default screen tip behavior.
Overrides:
This method is used internally to control screen tip display through the ManageToolTip(Point, TreeMapDataItem, TreeMapDataItemGroup) method instead.
Raises the ToolTipShowing event.
protected virtual void OnToolTipShowing(TreeMapToolTipEventArgs args)The event arguments containing tooltip information and cancellation capability.
Renders the visual content of the treemap by painting groups or individual items.
protected override void PaintContent(IGraphics graphics)The graphics object used for rendering.
Overrides:
This method serves as the main entry point for treemap rendering. It delegates to either group painting or item painting based on whether grouping is enabled and groups exist.
Renders a single treemap group including its header, background, border, and contents.
public virtual void PaintGroup(IGraphics graphics, TreeMapDataItemGroup group)The graphics object used for rendering.
groupTreeMapDataItemGroupThe group to paint.
This method handles the complete rendering of a group, including raising the GroupPainting event for customization, painting the header background and text, drawing borders, and rendering child content.
Renders the border around a group and the separator line below the header.
protected virtual void PaintGroupBorder(TreeMapDataItemGroup group, IGraphics graphics, RectangleF rectangle, RectangleF headerRect, Color borderColor)The group whose border is being painted.
graphicsIGraphicsThe graphics object used for rendering.
rectangleRectangleFThe overall rectangle of the group.
headerRectRectangleFThe rectangle area of the header.
borderColorColorThe border color to use.
Renders the content area of a group, including child groups or items.
protected virtual void PaintGroupContent(TreeMapDataItemGroup group, IGraphics graphics)The group whose content is being painted.
graphicsIGraphicsThe graphics object used for rendering.
This method recursively paints child groups if they exist, otherwise it paints the individual items within the group.
Renders the background of a group header.
protected virtual void PaintGroupHeaderBackground(TreeMapDataItemGroup group, IGraphics graphics, RectangleF headerRect, Color backColor)The group whose header background is being painted.
graphicsIGraphicsThe graphics object used for rendering.
headerRectRectangleFThe rectangle area of the header.
backColorColorThe background color to use.
Renders the text content of a group header.
protected virtual void PaintGroupHeaderText(TreeMapDataItemGroup group, IGraphics graphics, RectangleF headerRect, string groupText, Color foreColor, Font font, ContentAlignment textAlignment)The group whose header text is being painted.
graphicsIGraphicsThe graphics object used for rendering.
headerRectRectangleFThe rectangle area of the header.
groupTextstringThe text to display.
foreColorColorThe text color to use.
fontFontThe font to use for text rendering.
textAlignmentContentAlignmentThe alignment of the text within the header rectangle.
Renders a collection of treemap groups.
public virtual void PaintGroups(IGraphics graphics, IEnumerable<TreeMapDataItemGroup> groups)The graphics object used for rendering.
groupsIEnumerable<TreeMapDataItemGroup>The collection of groups to paint.
This method iterates through all groups and calls PaintGroup(IGraphics, TreeMapDataItemGroup) for each one.
Renders a single treemap item including its background, text, and border.
public virtual void PaintItem(IGraphics graphics, TreeMapDataItem dataItem)The graphics object used for rendering.
dataItemTreeMapDataItemThe item to paint.
This method handles the complete rendering of an item, including applying selection and hover effects, raising the ItemPainting event for customization, and painting the background, text, and border.
Renders the background of a treemap item.
protected virtual void PaintItemBackground(TreeMapDataItem dataItem, IGraphics graphics, RectangleF rectangle, Color backColor)The item whose background is being painted.
graphicsIGraphicsThe graphics object used for rendering.
rectangleRectangleFThe rectangle area to fill.
backColorColorThe background color to use.
Renders the border around a treemap item.
protected virtual void PaintItemBorder(TreeMapDataItem dataItem, IGraphics graphics, RectangleF rectangle, Color borderColor, int borderWidth)The item whose border is being painted.
graphicsIGraphicsThe graphics object used for rendering.
rectangleRectangleFThe rectangle area for the border.
borderColorColorThe border color to use.
borderWidthintThe width of the border in pixels.
Renders a collection of treemap items.
public virtual void PaintItems(IGraphics graphics, IEnumerable<TreeMapDataItem> items)The graphics object used for rendering.
itemsIEnumerable<TreeMapDataItem>The collection of items to paint.
This method iterates through all items and calls PaintItem(IGraphics, TreeMapDataItem) for each one.
Renders the text content of a treemap item.
protected virtual void PaintItemText(TreeMapDataItem dataItem, IGraphics graphics, RectangleF rectangle, string text, Color foreColor, Font font, ContentAlignment textAlignment)The item whose text is being painted.
graphicsIGraphicsThe graphics object used for rendering.
rectangleRectangleFThe rectangle area for text placement.
textstringThe text to display.
foreColorColorThe text color to use.
fontFontThe font to use for text rendering.
textAlignmentContentAlignmentThe alignment of the text within the rectangle.
Determines whether a child element should be arranged during the layout process.
protected override bool ShouldArrangeChild(RadElement child)The child element to evaluate.
Returns:False if the child is the title stack or legend stack; otherwise, the base implementation result.
Overrides:
The title and legend stacks are handled separately in the layout process and do not participate in the normal child arrangement cycle.
Determines whether a child element should be measured during the layout process.
protected override bool ShouldMeasureChild(RadElement child)The child element to evaluate.
Returns:False if the child is the title stack or legend stack; otherwise, the base implementation result.
Overrides:
The title and legend stacks are handled separately in the layout process and do not participate in the normal child measurement cycle.
Updates the legend visibility and content based on current settings.
protected virtual void UpdateLegend()This method refreshes the legend visual items if the legend is enabled, then updates the legend visibility based on grouping state and legend display settings.
Updates the visibility state of the legend element based on current conditions.
protected virtual void UpdateLegendVisibility()The legend is visible only when there are groups, ShowLegend is true, and LegendPosition is not None. Changes in visibility trigger layout updates.
Events
Occurs when the treemap layout Algorithm has been evaluated and all items have valid bounds.
public event EventHandler AlgorithmEvaluatedThis event is raised after the algorithm calculates the size and position of all rectangles in the treemap, providing an opportunity to perform custom operations on the calculated layout.
Occurs after a group and its items have been painted, providing an opportunity for post-rendering operations.
public event TreeMapGroupPaintedEventHandler GroupPaintedThis event is raised after the complete group rendering is finished, including all child content, allowing for additional custom drawing or overlay effects.
Occurs before a group is painted, allowing custom rendering or modification of paint parameters.
public event TreeMapGroupPaitingEventHandler GroupPaintingThis event provides access to the graphics object and paint parameters, enabling custom rendering logic for group headers, backgrounds, and borders.
Occurs when the hovered group changes due to mouse movement.
public event TreeMapGroupChangedEventHandler HoveredGroupChangedThis event is raised when the mouse moves over different groups in the treemap, provided that AllowHotTracking is enabled.
Occurs when the hovered item changes due to mouse movement.
public event TreeMapItemChangedEventHandler HoveredItemChangedThis event is raised when the mouse moves over different items in the treemap, provided that AllowHotTracking is enabled.
Occurs when a TreeMapDataItem needs to be created during data binding operations.
public event TreeMapItemCreatingEventHandler ItemCreatingThis event allows customization of the item creation process, enabling the use of custom item types or initialization of item properties during data binding.
Occurs when a data-bound item is being attached to a TreeMapDataItem instance.
public event TreeMapItemEventHandler ItemDataBoundThis event is raised after an item has been created and bound to its data source object, allowing for custom initialization or property mapping.
Occurs after an item has been painted, providing an opportunity for post-rendering operations.
public event TreeMapItemPaitedEventHandler ItemPaintedThis event is raised after the standard item rendering is complete, allowing for additional custom drawing or overlay effects.
Occurs before an item is painted, allowing custom rendering or modification of paint parameters.
public event TreeMapItemPaitingEventHandler ItemPaintingThis event provides access to the graphics object and paint parameters, enabling custom rendering logic or modification of colors, fonts, and other visual properties.
Occurs before a screen tip is displayed, allowing customization or cancellation.
public event TreeMapScreenTipEventHandler ScreenTipShowingThis event provides access to the screen tip element and allows modification of its content or cancellation of its display by setting the Cancel property to true.
Occurs after the selected group has changed.
public event TreeMapGroupChangedEventHandler SelectedGroupChangedThis event is raised after a successful selection change, providing information about the previous and current selected groups.
Occurs before the selected group changes, providing an opportunity to cancel the selection.
public event TreeMapGroupChangingEventHandler SelectedGroupChangingThis event can be cancelled by setting the Cancel property of the event arguments to true, which will prevent the selection change from occurring.
Occurs after the selected item has changed.
public event TreeMapItemChangedEventHandler SelectedItemChangedThis event is raised after a successful selection change, providing information about the previous and current selected items.
Occurs before the selected item changes, providing an opportunity to cancel the selection.
public event TreeMapItemChangingEventHandler SelectedItemChangingThis event can be cancelled by setting the Cancel property of the event arguments to true, which will prevent the selection change from occurring.
Occurs before a tooltip is displayed, allowing customization or cancellation.
public event TreeMapToolTipEventHandler ToolTipShowingThis event provides access to the tooltip parameters and allows modification of the text, location, duration, or cancellation of the tooltip display.