GroupByRow Class

Specialization of the Row class which represents a row in which ColumnManagerCell objects can be drag and dropped in order to group a grid's data rows.

Syntax

Visual Basic
C#

'Declaration
 
<DescriptionAttribute("A row in the grid or group.")>
<ToolboxItemAttribute(False)>
<DesignerAttribute("Xceed.Grid.Design.RowDesigner,Xceed.Grid.v4.3.Design,Version=4.3.20076.12375,Culture=neutral,PublicKeyToken=ba83ff368b7563c6")>
<DefaultEventAttribute("Click")>
<DesignTimeVisibleAttribute(False)>
<DefaultPropertyAttribute("BackColor")>
Public Class GroupByRow 
   Inherits Row

'Usage
 
Dim instance As GroupByRow

[Description("A row in the grid or group.")]
[ToolboxItem(false)]
[Designer("Xceed.Grid.Design.RowDesigner,Xceed.Grid.v4.3.Design,Version=4.3.20076.12375,Culture=neutral,PublicKeyToken=ba83ff368b7563c6")]
[DefaultEvent("Click")]
[DesignTimeVisible(false)]
[DefaultProperty("BackColor")]
public class GroupByRow : Row

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).

Rows that do not contain cells can be used to display labels or manage other rows in the grid. Xceed Grid for .NET provides 4 cell-less row classes: the TextRow class which is used to display text, the GroupManagerRow class which is used to manage groups, the GroupByRow class which represents a row in which ColumnManagerCell objects can be drag and dropped in order to group a grid's data rows and the SpacerRow class which represents a row that is used to provide spacing between rows and detail grids in the grid. All of these rows derive directly from the Row class.

Every row that contains cells derives from the CellRow class. Theses rows will contain a cell for each column in the grid. Each of these cells will always have the same index, name and width as its parent column.

There are 4 specializations of the CellRow class: the DataRow class which represents a row that is bound to a data source or user provided data, the ValueRow class which contains a cell for each column in the grid but is not bound to a data source, the InsertionRow class which contains a cell for each column in the grid and is used by the end-user to insert new DataRow objects into the grid and the ColumnManagerRow class which represents a row that is used to manage the columns in the grid.

Inheritance Hierarchy

System.Object
   System.MarshalByRefObject
      Xceed.Grid.GridElementBase
         Xceed.Grid.GridElement
            Xceed.Grid.VisualGridElement
               Xceed.Grid.Row
                  Xceed.Grid.GroupByRow

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

GroupByRow Members
Xceed.Grid Namespace