TcxCustomInplaceEditContainer.PropertiesClass Property
Specifies a reference to the editor properties class that corresponds to the active in-place editor type.
#Declaration
property PropertiesClass: 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 data item in a container control can use any editor shipped with the ExpressEditors Library as an in-place editor for cell edit operations. An in-place editor 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.
Use the PropertiesClass
property to switch between available in-place editors if the RepositoryItem property is unspecified.
To configure the active in-place editor, use the Properties property.
#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 data item’s Properties node and select the required editor from the invoked drop-down list.
#Property Setter Behavior
The PropertiesClass
property setter updates Properties and PropertiesClassName 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 a tree list column, assigns an in-place date editor with a drop-down calendar, and customizes its settings:
uses cxCalendar;
// ...
var
AColumn: TcxTreeListColumn;
ADateEditProperties: TcxDateEditProperties;
begin
AColumn := cxTreeList1.CreateColumn; // Creates a new unbound column
AColumn.DataBinding.ValueType := 'DateTime'; // Changes the column value type to "DateTime"
AColumn.PropertiesClass := TcxDateEditProperties; // Assigns an in-place spin editor
ADateEditProperties := AColumn.Properties as TcxDateEditProperties;
ADateEditProperties.ShowToday := False; // Hides the "Today" link
ADateEditProperties.DateButtons := [btnClear, btnToday]; // Adds the "Today" button
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,
PropertiesClass
, Properties, and PropertiesClassName property values are ignored.
Important
Do not change Properties
, Properties
To change the active editor and modify its settings safely within these event handlers, use the Repository
#Default In-Place Editors
A data item in a container control uses the default in-place editor if Properties, PropertiesClass
, PropertiesClassName, and RepositoryItem properties are unspecified. The container control item 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 container control item regardless of the active data access mode.