Group Class

Represents a group in the grid.

Syntax

Visual Basic
C#

'Declaration
 
<DescriptionAttribute("A group in the grid.")>
<DesignerAttribute("Xceed.Grid.Design.GroupDesigner,Xceed.Grid.v4.3.Design,Version=4.3.20076.12375,Culture=neutral,PublicKeyToken=ba83ff368b7563c6")>
<DefaultPropertyAttribute("GroupBy")>
<DefaultEventAttribute("DataRowsChanged")>
<ToolboxItemAttribute(False)>
<DesignTimeVisibleAttribute(False)>
Public Class Group 
   Inherits GroupBase

'Usage
 
Dim instance As Group

[Description("A group in the grid.")]
[Designer("Xceed.Grid.Design.GroupDesigner,Xceed.Grid.v4.3.Design,Version=4.3.20076.12375,Culture=neutral,PublicKeyToken=ba83ff368b7563c6")]
[DefaultProperty("GroupBy")]
[DefaultEvent("DataRowsChanged")]
[ToolboxItem(false)]
[DesignTimeVisible(false)]
public class Group : GroupBase

Remarks

Any changes made to the grid's grouping using the GroupByRow results in the recreation of the group templates. This means that you cannot keep a long term reference on a specific group in the group templates and that, in code, a group used as a template should not be accessed using its component name (gridControl1.GroupTemplates[ 0 ] should be used rather than group1).

DataRows can be grouped automatically or manually. To do automatic grouping, the GroupBy property of a group must be set to the Column.FieldName of the column in the grid by which the DataRows are to be grouped. To group the data rows manually, the QueryGroupKeys event can be used. This event can be used in conjunction with the GroupBy property to provide additional custom grouping criteria.

Groups by themselves do not have a visual representation. In order for groups to have a visual representation, they usually contain at least one row that is not a data row in their header or footer sections. Typically, a GroupManagerRow is added to the GroupBase.HeaderRows of a group to create an Outlook style grid.

Inheritance Hierarchy

System.Object
   System.MarshalByRefObject
      Xceed.Grid.GridElementBase
         Xceed.Grid.GridElement
            Xceed.Grid.GroupBase
               Xceed.Grid.Group

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

Group Members
Xceed.Grid Namespace