New to Telerik UI for WinForms? Start a free 30-day trial

Represents a tree map region that contains data items or nested groups.

A group's display and value members inherit from its parent group, then from the owning tree map, unless the group provides its own member names.

Definition

Constructors

Initializes an empty group with its own item and child-group collections.

C#
public TreeMapDataItemGroup()

The default HeaderHeight value is 26; layout scales it for the current DPI.

Initializes an empty group with the specified display text.

C#
public TreeMapDataItemGroup(string text)
Parameters:textstring

The text displayed in the group header.

Properties

Gets or sets the tree map algorithm for this group.

C#
[Browsable(false)]
public TreeMapAlgorithm Algorithm { get; set; }

Gets the data group that is assigned to this group.

C#
[Browsable(false)]
public Group<TreeMapDataItem> DataGroup { get; }

Gets or sets the display member.

C#
[Browsable(true)]
[TypeConverter("System.Windows.Forms.Design.DataMemberFieldConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string DisplayMember { get; set; }

Gets null and ignores attempts to set the inherited item-group property.

C#
[Browsable(false)]
public override TreeMapDataItemGroup Group { get; set; }

Overrides: TreeMapDataItem.Group

Use ParentGroup and Groups to represent group hierarchy.

Gets the child groups, synchronizing them with the associated data-view group when present.

C#
public IList<TreeMapDataItemGroup> Groups { get; }

Reading this property can cause child groups to be materialized from the data view and their item lists to be refreshed.

Gets or sets the height of the header.

C#
public int? HeaderHeight { get; set; }

Gets or sets whether this group was created from the tree map's data-view grouping.

C#
[Browsable(false)]
public bool IsAutoGenerated { get; set; }

Automatically generated groups are reconciled with the data view as its groups change.

Gets the items in this group.

C#
[Browsable(false)]
public TreeMapGroupedItemsCollection Items { get; }

Gets or sets the legend title.

C#
public string LegendTitle { get; set; }

Gets or sets the parent group.

C#
public TreeMapDataItemGroup ParentGroup { get; set; }

Gets or sets the value member.

C#
[Browsable(true)]
public string ValueMember { get; set; }

Methods

Removes the items from this group, disposes its item collection, and releases base item resources.

C#
public override void Dispose()

Overrides: TreeMapDataItem.Dispose()

Assigns this group's bounds and calculates bounds for its child groups or items.

C#
protected virtual void EvaluateAlgorithm(RectangleF rect)
Parameters:rectRectangleF

The rectangle available to the group, including its header area.

The group's algorithm partitions the content area below the header. Items without a numeric value receive empty bounds; nested groups are laid out recursively.

Collects the numeric values represented by this group and its descendants.

C#
protected virtual IEnumerable<double> GetValues()
Returns:

IEnumerable<double>

The descendant item values that are present; child groups contribute their item values.

For a leaf group, each item's current value is also stored in its AlgorithmValue.

Propagates an owner change to this group's items before raising the base property-change notification.

C#
protected override void OnNotifyPropertyChanged(PropertyChangedEventArgs args)
Parameters:argsPropertyChangedEventArgs

The property change details.

Overrides: TreeMapDataItem.OnNotifyPropertyChanged(PropertyChangedEventArgs)