This documentation topic describes legacy technology. We no longer develop new functionality for the GridControl and suggest that you use the new DataGridView control instead.
A GridControl presents its data with the help of rows and columns. This document provides an overview of row types available in the grid. To get detailed information on grid columns, review the Columns section.
A data source represents tabular information using data fields and records. A GridControl bound to a data source displays data fields as columns, and records as data rows. These rows are displayed one after another. Record values are arranged horizontally within them.
When an end-user taps a data row in the grid, this row is selected. To set a selected row programmatically, use the GridControl.SelectedRowHandle method.
When grouping is applied in a GridControl, the grid displays group rows. These rows function to separate data row groups and can also be expanded and collapsed to show and hide data rows that belong to a group.
Rows are always sorted against the grouping column. If data is grouped against a column which is not sorted, the grid will automatically apply sorting to the column in ascending order.
A group row displays the following elements:
Group Expand Icon - Indicates whether the group is expanded or collapsed.
Grouping Column - A caption of a column by whose values data is grouped.
Group Row Value - A data value of a grouping column for which the group is created.
Each group row is identified by a unique integer value - row handle. Group row handles are negative (starting from -1). You can obtain detailed information on an individual data group using the GridControl.GetGroupInfo method with the corresponding group row handle passed as a parameter. This method returns an object implementing the IGroupInfo interface that provides a set of properties to get information on a particular data group. For example, the following table lists properties that you can use to get information displayed in the specified group row.
When an end-user taps and holds a group row, a context menu appears allowing end-users to manage groups (calculate group summaries, collapse and expand all groups at once, and remove grouping from the grid). To prevent this menu from being shown, set the GridControl.IsGroupRowMenuEnabled property to false.
We are updating the DevExpress product documentation website and this page is part of our new experience. During this transition period, product documentation remains available in our previous format at documentation.devexpress.com. Learn More...
Was this page helpful?
Thanks for your feedback! Any other suggestions? Tell us here.