TcxDBEditorRow Class

A data-aware vertical grid row.

Declaration

delphi

TcxDBEditorRow = class(
    TcxCustomEditorRow
)

Remarks

A vertical grid row contains one header and displays one data cell per column.

In-Place Editors

A vertical grid row can use any editor shipped with the ExpressEditors Library as an in-place editor for cell edit operations. An in-place editor instance exists (and, therefore, has its own WinAPI handle) only when a row cell is being edited. Otherwise, the column displays a static editor image for resource usage optimization.

To switch between available in-place editors, you can use the Properties.EditPropertiesClass property. Use the Properties.EditProperties property to configure the in-place editor associated with the vertical grid row.

In-Place Editors and Repository Items

Alternatively, you can assign an edit repository item component to the Properties.RepositoryItem property and use the repository item to define the active in-place editor and customize its settings.

Note

If an edit repository item is assigned to the Properties.RepositoryItem property, Properties.EditProperties, Properties.EditPropertiesClass, and Properties.EditPropertiesClassName properties have no effect.

Multiple In-Place Editors in One Row

You can handle Properties.OnGetEditProperties and Properties.OnGetEditingProperties events to dynamically change the assigned in-place editor and its settings based on custom conditions.

Important

Do not change Properties.EditPropertiesClass, Properties.EditPropertiesClassName, and Properties.EditProperties property values directly in Properties.OnGetEditProperties and Properties.OnGetEditingProperties event handlers.

To change the active editor and modify its settings safely within these event handlers, use the Properties.RepositoryItem property and TcxEditRepositoryItem class descendants.

Main API Members

The list below outlines key members of the TcxDBEditorRow class that allow you to configure vertical grid rows.

Appearance Customization

HeightSpecifies the height of the vertical grid row, in pixels.StylesAllows you to change the appearance of different vertical grid row elements.

Vertical Grid Control-Related API Members

Collapse | Expand | ExpandedExpand or collapse the vertical grid row if it has nested rows.FocusedSpecifies if the vertical grid row has focus.HasChildren | HasVisibleChildren | CountAllow you to check if the vertical grid row has nested rows.IndexSpecifies the row’s position in the parent vertical grid control.LevelReturns the vertical grid row’s nesting level.MakeVisibleScrolls the parent vertical grid control to display the current row.RowsProvides access to the collection of nested vertical grid rows.

General-Purpose API Members

OptionsProvides access to vertical grid row behavior settings.PropertiesProvides access to the general, editor, and data binding settings of the vertical grid row. Properties.EditPropertiesClass and Properties.EditProperties properties allow you to change the in-place editor associated with the vertical grid row and configure the editor.RestoreDefaultsRestores the default vertical grid row behavior settings accessible through the Options property.VerticalGridProvides access to the Vertical Grid control to which the row belongs.VisibleSpecifies if the vertical grid row is visible.

Direct TcxEditorRow Class Reference

The TcxVerticalGridRows.Items property references the TcxDBEditorRow class as a TcxCustomRow object.

Inheritance

TObject TPersistent TComponent TcxCustomRow TcxCustomEditorRow TcxDBEditorRow