Skip to main content

TcxCustomGridTableItem.PropertiesClassName Property

Specifies the in-place editor type by its class name.

Declaration

property PropertiesClassName: string read; write;

Property Value

Type Description
string

The name of the active in-place editor properties class.

Warning

An assigned name should match the name of any existing terminal TcxCustomEditProperties class descendant; otherwise, runtime errors may occur.

We recommend that you use the PropertiesClass or RepositoryItem property to specify the required in-place editor type in code.

Remarks

A data item 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 data item cell is being edited. Otherwise, the data item displays a static editor image for resource usage optimization.

VCL Data Grid: An In-Place Spin Editor

Warning

The PropertiesClassName property is designed to store the name of the required editor settings class in a DFM file. If a name assigned to the PropertiesClassName property in code does not match an existing terminal TcxCustomEditProperties class descendant, runtime errors may occur.

Since a RAD Studio® compiler cannot verify that a correct class name is assigned to the PropertiesClassName property, we recommend that you use the PropertiesClass property or assign a configured repository item component to the RepositoryItem property to define the required in-place editor for the data item.

To configure the active in-place editor, use the Properties property.

Editor Selection at Design Time

At design time, you can use the Object Inspector to select any available in-place editor. Click a grid table item’s Properties node and select the required editor from the invoked drop-down list.

VCL Data Grid: An In-Place Editor List in the Object Inspector

Property Setter Behavior

The PropertiesClassName property setter updates Properties and PropertiesClass property values according to the selected in-place editor type.

Code Example: Create an Unbound Column and Configure Its In-Place Editor

The following code example creates an unbound Table View column, assigns an in-place spin editor to it, and limits the editor’s input value range:

uses cxSpinEdit;
// ...
var
  AColumn: TcxGridColumn;
  ASpinEditProperties: TcxSpinEditProperties;
begin
  AColumn := cxGrid1TableView1.CreateColumn;  // Creates a new unbound column
  AColumn.DataBinding.ValueType := 'Currency'; // Changes the column value type to "Currency"
  AColumn.PropertiesClassName := 'TcxSpinEditProperties'; // Assigns an in-place spin editor
  ASpinEditProperties := AColumn.Properties as TcxSpinEditProperties;
  ASpinEditProperties.MinValue := 0;  // Sets the minimum edit value
  ASpinEditProperties.MaxValue := 1000; // Sets the maximum edit value
  ASpinEditProperties.Circular := True; // Loops value changes within the defined range
end;

VCL Data Grid: A Column with an In-Place Spin Editor

Important Limitations

  • If an editor has unbound and data-aware versions, you can use only its unbound version as an in-place editor.
  • If the RepositoryItem property is specified, PropertiesClassName, Properties, and PropertiesClass property values are ignored.

Important

Do not change PropertiesClass, PropertiesClassName, and Properties property values in OnGetProperties and OnGetPropertiesForEdit event handlers. Otherwise, drawing errors and access violations may occur.

To change the active editor and modify its settings safely within these event handlers, use the RepositoryItem property and TcxEditRepositoryItem class descendants. Refer to OnGetProperties and OnGetPropertiesForEdit event descriptions for detailed information and code examples.

Default In-Place Editors

A grid table item uses the default in-place editor if Properties, PropertiesClass, PropertiesClassName, and RepositoryItem properties are unspecified. The grid table item uses one of the following in-place editors as default depending on DataBinding.ValueType and DataBinding.ValueTypeClass property values:

ValueType[1] Value ValueTypeClass[1] Value Default Editor
'Boolean' TcxBooleanValueType TcxCheckBox
'Currency' TcxCurrencyValueType TcxCurrencyEdit
'DateTime' TcxDateTimeValueType TcxDateEdit
'FMTBcd' TcxFMTBcdValueType TcxCurrencyEdit
'SQLTimeStamp' TcxSQLTimeStampValueType TcxDateEdit
Any other value Any other value TcxTextEdit
Footnotes
  1. DataBinding.ValueType and DataBinding.ValueTypeClass property values define the default in-place editor for the grid table item regardless of the active data access mode.

See Also