TcxPivotGridField.PropertiesClassName Property
Specifies the active editor type by its class name.
#Declaration
property PropertiesClassName: string read; write;
#Property Value
Type | Description |
---|---|
string | The name of the active editor properties class. Warning An assigned name should match the name of any existing terminal Tcx We recommend that you use the Properties |
#Remarks
A pivot grid field can use any editor shipped with the ExpressEditors Library to display data in cells.
Warning
The Properties
property is designed to store the name of the required editor settings class in a DFM file. If a name assigned to the Properties
property in code does not match an existing terminal Tcx
Since a RAD Studio® compiler cannot verify that a correct class name is assigned to the Properties
property, we recommend that you use the Properties
To configure the active editor, use the Properties property.
#Editor Selection at Design Time
At design time, you can use the Object Inspector to select any available editor. Click a pivot grid field’s Properties node and select the required editor from the invoked drop-down list.
#Property Setter Behavior
The PropertiesClassName
property setter updates Properties and PropertiesClass property values according to the selected in-place editor type.
#Code Example: Display Cell Values as Progress Bars
The following code example assigns a progress bar editor to a pivot grid field that displays percentages:
// ...
uses
cxProgressBar;
// ...
var
AProperties: TcxProgressBarProperties;
begin
pgfQuantityPercent.PropertiesClassName := 'TcxProgressBarProperties';
AProperties := pgfQuantityPercent.Properties as TcxProgressBarProperties;
AProperties.BarStyle := cxbsAnimation;
AProperties.BeginColor := clLime;
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,
PropertiesClassName
, Properties, and PropertiesClass property values are ignored.
Important
Do not change Properties
, Properties, and Properties
To change the active editor and modify its settings safely within these event handlers, use the Repository
#Default Editors
A pivot grid field uses the default editor to display data if Properties, PropertiesClass, and PropertiesClassName
properties are unspecified. The pivot grid field uses one of the following 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 pivot grid field regardless of the active data access mode.