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

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

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:

• Delphi
• C++

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;

#include "cxCalendar.hpp"
// ...
  TcxTreeListColumn *AColumn;
  TcxDateEditProperties *ADateEditProperties;
  // ...
  AColumn = cxTreeList1->CreateColumn(); // Creates a new unbound column
  AColumn->DataBinding->ValueType = "DateTime"; // Changes the column value type to "DateTime"
  AColumn->PropertiesClass = __classid(TcxDateEditProperties); // Assigns an in-place spin editor
  ADateEditProperties = dynamic_cast<TcxDateEditProperties*>(AColumn->Properties);
  ADateEditProperties->ShowToday = false; // Hides the "Today" link
  ADateEditProperties->DateButtons = TDateButtons() << btnClear << btnToday; // Adds the "Today" button

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 PropertiesClass, PropertiesClassName, and Properties property values in OnGetEditProperties and OnGetEditingProperties 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 OnGetEditProperties and OnGetEditingProperties event descriptions for detailed information and code examples.

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:

Footnotes

1. 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.

See Also

TcxFilterItem.PropertiesClass Property

TcxCustomBarEditItem.PropertiesClass Property

TcxCustomGridTableItem.PropertiesClass Property

TcxPivotGridField.PropertiesClass Property

TcxCustomEditorRowProperties.EditPropertiesClass Property

TcxCustomInplaceEditContainer Class

TcxCustomInplaceEditContainer Members

cxInplaceContainer Unit