TcxCustomEditorRowProperties.EditPropertiesClass Property
Specifies a reference to the editor properties class that corresponds to the active in-place editor type.
#Declaration
property EditPropertiesClass: TcxCustomEditPropertiesClass read; write;
#Property Value
Type | Description |
---|---|
Tcx |
The class-reference to the editor properties class that corresponds to the active in-place editor type. Refer to the Remarks section for the full list of available in-place editor types. |
#Remarks
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 data cell is being edited. Otherwise, the vertical grid row displays a static editor image for resource usage optimization.
Use the EditPropertiesClass
property to switch between available in-place editors if the RepositoryItem property is unspecified.
#Available In-Place Editors
Properties |
In-Place Editor | Description |
---|---|---|
Tdx |
Tdx |
A barcode control without user input functionality. |
Tcx |
Tcx |
A Binary Large Object (BLOB) editor. |
Tcx |
Tcx |
A single-line text editor with embedded buttons. |
Tcx |
Tcx |
A single-line editor with a drop-down calculator window. |
Tcx |
Tcx |
A check box editor with support for three states. |
Tcx |
Tcx |
A combo box editor that can display items with check boxes. |
Tcx |
Tcx |
An editor designed to display a set of check boxes. |
Tcx |
Tcx |
A color combo box editor. |
Tdx |
Tdx |
An editor designed to select a color in a color gallery embedded into a drop-down window. |
Tcx |
Tcx |
A general-purpose combo box editor. |
Tcx |
Tcx |
A numeric editor for currency values. |
Tcx |
Tcx |
A date editor with a drop-down calendar. |
Tdx |
Tdx |
A date/time wheel picker editor. |
Tcx |
Tcx |
A lookup editor that displays a Data Grid View in a drop-down window. |
Tcx |
Tcx |
A combo box that allows users to switch between font typefaces. |
Tdx |
Tdx |
A formatted label editor without user input functionality. |
Tcx |
Tcx |
A hyperlink editor that can execute custom commands. |
Tcx |
Tcx |
An editor designed to display images. |
Tcx |
Tcx |
A combo box whose items can display text and images. |
Tcx |
Tcx |
An unformatted label editor without user input functionality. |
Tcx |
Tcx |
A lookup combo box populated with values from a data source. |
Tdx |
Tdx |
A lookup sparkline editor. |
Tcx |
Tcx |
A single-line text editor with support for input masks. |
Tcx |
Tcx |
A multi-line editor for plain text. |
Tcx |
Tcx |
A single-line text editor that displays a list of most recently used (MRU) items in a drop-down window. |
Tdx |
Tdx |
A numeric value wheel picker editor. |
Tdx |
Tdx |
A search box that suggests Ribbon or Toolbar UI elements based on user input. |
Tcx |
Tcx |
A text editor that can embed a control in a drop-down window. |
Tcx |
Tcx |
A progress bar. |
Tcx |
Tcx |
A container for radio buttons. |
Tdx |
Tdx |
A track bar editor with two sliders for value range selection. |
Tdx |
Tdx |
A rating control. |
Tcx |
Tcx |
A multi-line rich text editor. |
Tcx |
Tcx |
An editor that combines a combo box and a Shell Tree View control. |
Tdx |
Tdx |
An editor that visualizes data as lightweight charts without axes and labels. |
Tcx |
Tcx |
A general-purpose numeric spin editor. |
Tcx |
Tcx |
A simple single-line text editor. |
Tcx |
Tcx |
A spin editor for time values. |
Tdx |
Tdx |
A toggle switch editor. |
Tdx |
Tdx |
A token editor. |
Tcx |
Tcx |
A track bar editor with one slider. |
#Editor Selection at Design Time
At design time, you can use the Object Inspector to select any available in-place editor. Click a vertical grid row’s Properties.EditProperties node and select the required editor from the invoked drop-down list.
#Property Setter Behavior
The EditPropertiesClass
property setter updates EditProperties and EditPropertiesClassName property values according to the selected in-place editor type.
#Code Example: Create an Unbound Row and Configure Its In-Place Editor
The following code example creates an unbound vertical grid row, assigns an in-place spin editor, and customizes its settings:
// ...
uses
cxSpinEdit;
// ...
var
AEditorRow: TcxEditorRow;
ASpinEditProperties: TcxSpinEditProperties;
begin
AEditorRow := TcxEditorRow(cxVerticalGrid1.Add(TcxEditorRow)); // Creates an unbound vertical grid row
AEditorRow.Properties.DataBinding.ValueType := 'Float'; // Changes the row value type to "Float"
AEditorRow.EditPropertiesClass := TcxSpinEditProperties; // Assigns an in-place spin editor
ASpinEditProperties := AEditorRow.Properties.EditProperties as TcxSpinEditProperties;
ASpinEditProperties.MinValue := 0; // Sets the minimum edit value
ASpinEditProperties.MaxValue := 100; // Sets the maximum edit value
ASpinEditProperties.DisplayFormat := '0.00 %'; // Defines a formatting pattern for display text
ASpinEditProperties.Circular := True; // Loops value changes within the defined range
end;
#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, EditProperties, EditPropertiesClassName, and
EditPropertiesClass
property values are ignored.
Important
Do not change Edit
, Edit
To change the active editor and modify its settings safely within these event handlers, use the Repository
#Default In-Place Editors
A vertical grid row uses the default in-place editor if EditProperties, EditPropertiesClass
, EditPropertiesClassName, and RepositoryItem properties are unspecified. The vertical grid row uses one of the following in-place editors as default depending on DataBinding.ValueType and DataBinding.ValueTypeClass property values:
Value |
Value |
Default Editor |
---|---|---|
Boolean |
Tcx |
Tcx |
Currency |
Tcx |
Tcx |
Date |
Tcx |
Tcx |
FMTBcd |
Tcx |
Tcx |
SQLTime |
Tcx |
Tcx |
Any other value | Any other value | Tcx |
-
DataBinding.ValueType and DataBinding.ValueTypeClass property values define the default in-place editor for the vertical grid row regardless of the active data access mode.