Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Overview
   [Expand]Fundamentals
   [Collapse]Concepts
    [Expand]Layouts
    [Expand]Binding to Data
    [Collapse]Rows
     [Expand]Row Operations
      Row Class Structure
      Row Properties
      Category Rows
      Editor Rows
      Multi-Editor Rows
      Fixed Rows
    [Expand]Records
    [Expand]Cells
    [Expand]In-place Editors
     Formatting
    [Expand]Appearances
     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]Examples
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [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]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Row Properties

The vertical grid controls (VGridControl and PropertyGridControl) support various row types as described in the Rows Overview topic. Rows of different types have some common settings, the settings that are available for a particular row type is dependent upon the type of data it displays. Settings which depend upon data are stored in separate objects. This topic describes the manner in which these settings are implemented for different row types and, how they can be accessed and used.

Expanded Row Items

There are two key differences between row types. The first is whether a row type is capable of displaying data. The second is the number of cells displayed for each record. These differences define which settings are required by a particular row type. The list below enumerates all the available row types and explains the settings that are required by each type:

  • Rows that don't display any data cells - Category Rows. Rows of this type need only settings that affect their headers, such as the caption and image.
  • Rows that display a single cell within each record - Editor Rows. Rows of this type need settings that affect their headers and data settings. The data settings include the editor used to display and edit cell values, a format string, the name of the bound field, etc.
  • Rows that are capable of displaying multiple cells within each record - Multi-editor rows. Note that rows of this type have several header cells. Thus, they need several setting objects similar to the settings required by editor and caption rows.

You might already have noticed that the category and editor rows are similar since they require a single settings object - row item settings which is represented by a RowProperties descendant. Multi-editor rows can consist of several row items.

The image below illustrates the notion of a row item.

Expanded Accessing Row Properties (Row Item STEM )

Each row type has its own corresponding type of row item settings. Thus, the CategoryRowProperties, RowProperties and MultiEditorRowProperties classes provide settings for the CategoryRow, EditorRow and MultiEditorRow items, respectively. In simple rows the row item settings can be accessed using the row's Properties property. At design time you can access these settings by switching to the Row Properties tab in the Rows Page. The image below shows how to access the item settings of an editor row.

As explained above, complex rows (Multi-editor rows) can contain several row items and thus maintain a collection of row item settings. At runtime, this collection can be accessed via the row's MultiEditorRow.PropertiesCollection property. At design time, the Rows Page displays the tab pages that correspond to individual row items as shown in the image below.

The settings provided for row items are listed below:

For details on features specific to each row type, see the Category Rows, Editor Rows and Multi-editor rows topics.

How would you rate this topic?​​​​​​​