Log In
[Expand]Welcome to DevExpress .NET Documentation
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Collapse]Vertical Grid
    [Expand]Binding to Data
     [Expand]Row Operations
      Row Class Structure
      Row Properties
      Category Rows
      Editor Rows
      Multi-Editor Rows
      Fixed Rows
    [Expand]In-place Editors
     Hit Information
    [Expand]Custom Painting
    [Expand]Alpha Blending and Background Images
    [Expand]Customization Form
     Batch Modifications
    [Expand]Drag and Drop
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Category Rows

The vertical grid controls (VGridControl and PropertyGridControl) have different types of rows that are described in the Rows Overview topic. This topic deals with the features provided by category rows. It explains when such rows need to be used and how they can be customized.

Expanded Category Rows

Category rows don't display any data cells. These rows are used to arrange editor and multi-editor rows into groups. You might need them if the rows displayed within the vertical grid control can be logically divided into several categories. In this case related rows must be added to the corresponding category row as child rows. End-users can expand/collapse category rows.

The image below shows a VGridControl with expanded and collapsed categories.

Note: category rows don't necessarily reside at the first level within the grid control. They can also be child rows of other rows. You can provide sub-categories within a category. For details on how to implement a hierarchical row structure within a vertical grid, see the Creating a Tree-Like Structure of Rows topic.

Expanded Features of Category Rows

The base functionality is inherited from the BaseRow class. The CategoryRow class overrides the BaseRow.Properties property to return a CategoryRowProperties object which provides settings specific to category rows. Since category rows do not display any data cells, you can use these settings only to specify the row's caption and image. For this purpose, use the RowProperties.Caption and RowProperties.ImageIndex properties, respectively.

The image below illustrates the category row's settings.

To access the settings of specific rows at design time use the Rows Page.

Expanded Customizing Category Rows - Runtime Sample

The following sample code shows how to customize the 'Details' category's settings (image, appearance, height). The image below shows the vertical grid control before and after executing the sample code.

Is this topic helpful?​​​​​​​