Class ColumnHeaderSection
Defines the class that implements the section of the column headers.
Inheritance
Implements
Inherited Members
Namespace: Syncfusion.Grouping
Assembly: Syncfusion.Grouping.Base.dll
Syntax
public class ColumnHeaderSection : RowElementsSection, IDisposable, IDisposedEvent, IIsDisposedProperty, ITreeTableCounterSource, ITreeTableSummaryArraySource, IRowElementsContainer, IContainerElement, IElement, IElementTreeTableSourceRemarks
A ColumnHeaderSection holds ColumnHeaderRow(s) that are displayed at the top of a table or group. ColumnHeaderRow is a place holder item where the grouping grid should display column headers.
The ColumnHeaderSection is a container element and has a collection of one or multiple ColumnHeaderRow elements.
If ColumnHeaderSection(s) should be displayed at the top of each group, ColumnHeaderSection(s) are created when the grouping for a table is initialized. The grouping engine loops through all sorted records and categorizes them. For each new group the virtual TableDescriptor.CreateGroup factory method is called. The TableDescriptor.CreateGroup method instantiates a ColumnHeaderSection by calling the virtual TableDescriptor.CreateColumnHeaderSection factory method.
One set of ColumnHeaderRows are displayed at the top of the table below the CaptionSection. The rows belong to the ColumnHeaderSection of the TopLevelGroup of a table. The TopLevelGroup is created with the virtual TableDescriptor.CreateGroup factory method. The TableDescriptor.CreateGroup method instantiates a ColumnHeaderSection by calling the virtual TableDescriptor.CreateColumnHeaderSection factory method.
Because the ColumnHeaderSection is a container element and not a display element, it will not be an item returned by the Table.DisplayElements and Table.GroupedElements collections. Instead, the ColumnHeaderSection can be accessed only through the Group.Sections collection of its parent group or TopLevelGroup.
See also:
TableDescriptor.CreateGroup, TableDescriptor.CreateColumnHeaderSection, Table.TopLevelGroup, IContainerElement, Group.Sections
Constructors
ColumnHeaderSection(Group)
Initializes a new instance of the ColumnHeaderSection class in the specified group.
Declaration
public ColumnHeaderSection(Group parent)Parameters
| Type | Name | Description |
|---|---|---|
| Group | parent | The group this section is created in. |
Properties
ColumnHeaderRows
Gets the value of the collection of ColumnHeaderRow elements.
Declaration
public ColumnHeaderRowCollection ColumnHeaderRows { get; }Property Value
| Type | Description |
|---|---|
| ColumnHeaderRowCollection |
Kind
Overrides and gets the kind of display element.
Declaration
public override DisplayElementKind Kind { get; }Property Value
| Type | Description |
|---|---|
| DisplayElementKind |
Overrides
Methods
Dispose(Boolean)
Overrides and manages the unwanted resources.
Declaration
protected override void Dispose(bool disposing)Parameters
| Type | Name | Description |
|---|---|---|
| System.Boolean | disposing |
Overrides
FieldsToString()
Gets a concatenated string of all field names of Fields of the TableDescriptor this section belongs to.
Declaration
public string FieldsToString()Returns
| Type | Description |
|---|---|
| System.String | A string with comma-separated field names. |
GetElementCount()
Returns the number of elements.
Declaration
public override int GetElementCount()Returns
| Type | Description |
|---|---|
| System.Int32 | Number of elements. |
Overrides
GetFilteredRecordCount()
Overrides and gets the number of filtered records.
Declaration
public override int GetFilteredRecordCount()Returns
| Type | Description |
|---|---|
| System.Int32 | Number of filtered records. |
Overrides
GetRecordCount()
Overrides and gets the number of records.
Declaration
public override int GetRecordCount()Returns
| Type | Description |
|---|---|
| System.Int32 | Returns 0. |
Overrides
GetVisibleCount()
Overrides and gets the number of visible elements.
Declaration
public override int GetVisibleCount()Returns
| Type | Description |
|---|---|
| System.Int32 | Number of visible elements. |
Overrides
GetYAmountCount()
Overrides and gets the column header section height.
Declaration
public override double GetYAmountCount()Returns
| Type | Description |
|---|---|
| System.Double | Returns Height. |
Overrides
InvalidateCounterTopDown(Boolean)
Overrides and forces re-evaluation of all counters for all the table elements.
Declaration
public override void InvalidateCounterTopDown(bool notifyCounterSource)Parameters
| Type | Name | Description |
|---|---|---|
| System.Boolean | notifyCounterSource | When True notifies counter source. |
Overrides
OnEnsureInitialized(Object)
Overrides and determines whether the object is updated or not.
Declaration
protected override bool OnEnsureInitialized(object sender)Parameters
| Type | Name | Description |
|---|---|---|
| System.Object | sender |
Returns
| Type | Description |
|---|---|
| System.Boolean | Boolean value. |
Overrides
ToString()
Overrides and gets the string representation of ColumnHeaderSection.
Declaration
public override string ToString()Returns
| Type | Description |
|---|---|
| System.String | String representation of the current object. |