TcxPivotGridField.RepositoryItem Property

Specifies an edit repository item component for the pivot grid field.

Declaration

property RepositoryItem: TcxEditRepositoryItem read; write;

Property Value

Type	Description
TcxEditRepositoryItem	An edit repository item component.

Remarks

A pivot grid field can use any editor shipped with the ExpressEditors Library to display data in cells.

To assign an editor to the pivot grid field, you can create and configure an edit repository item component, and then assign it to the RepositoryItem property.

Tip

Edit repository items are useful when you need to share editor settings between multiple pivot grid fields or change active editor settings in an OnGetProperties event handler.

Available In-Place Editors

PropertiesClass Value	In-Place Editor	Description
TdxBarCodeProperties	TdxBarCode	A barcode control without user input functionality.
TcxBlobEditProperties	TcxBlobEdit	A Binary Large Object (BLOB) editor.
TcxButtonEditProperties	TcxButtonEdit	A single-line text editor with embedded buttons.
TcxCalcEditProperties	TcxCalcEdit	A single-line editor with a drop-down calculator window.
TcxCheckBoxProperties	TcxCheckBox	A check box editor with support for three states.
TcxCheckComboBoxProperties	TcxCheckComboBox	A combo box editor that can display items with check boxes.
TcxCheckGroupProperties	TcxCheckGroup	An editor designed to display a set of check boxes.
TcxColorComboBoxProperties	TcxColorComboBox	A color combo box editor.
TdxColorEditProperties	TdxColorEdit	An editor designed to select a color in a color gallery embedded into a drop-down window.
TcxComboBoxProperties	TcxComboBox	A general-purpose combo box editor.
TcxCurrencyEditProperties	TcxCurrencyEdit	A numeric editor for currency values.
TcxDateEditProperties	TcxDateEdit	A date editor with a drop-down calendar.
TdxDateTimeWheelPickerProperties	TdxDateTimeWheelPicker	A date/time wheel picker editor.
TcxExtLookupComboBoxProperties	TcxExtLookupComboBox	A lookup editor that displays a Data Grid View in a drop-down window.
TcxFontNameComboBoxProperties	TcxFontNameComboBox	A combo box that allows users to switch between font typefaces.
TdxFormattedLabelProperties	TdxFormattedLabel	A formatted label editor without user input functionality.
TcxHyperlinkEditProperties	TcxHyperLinkEdit	A hyperlink editor that can execute custom commands.
TcxImageProperties	TcxImage	An editor designed to display images.
TcxImageComboBoxProperties	TcxImageComboBox	A combo box whose items can display text and images.
TcxLabelProperties	TcxLabel	An unformatted label editor without user input functionality.
TcxLookupComboBoxProperties	TcxLookupComboBox	A lookup combo box populated with values from a data source.
TdxLookupSparklineProperties	TdxLookupSparklineEdit	A lookup sparkline editor.
TcxMaskEditProperties	TcxMaskEdit	A single-line text editor with support for input masks.
TcxMemoProperties	TcxMemo	A multi-line editor for plain text.
TcxMRUEditProperties	TcxMRUEdit	A single-line text editor that displays a list of most recently used (MRU) items in a drop-down window.
TdxNumericWheelPickerProperties	TdxNumericWheelPicker	A numeric value wheel picker editor.
TdxOfficeSearchBoxProperties	TdxOfficeSearchBox	A search box that suggests Ribbon or Toolbar UI elements based on user input.
TcxPopupEditProperties	TcxPopupEdit	A text editor that can embed a control in a drop-down window.
TcxProgressBarProperties	TcxProgressBar	A progress bar.
TcxRadioGroupProperties	TcxRadioGroup	A container for radio buttons.
TdxRangeTrackBarProperties	TdxRangeTrackBar	A track bar editor with two sliders for value range selection.
TdxRatingControlProperties	TdxRatingControl	A rating control.
TcxRichEditProperties	TcxRichEdit	A multi-line rich text editor.
TcxShellComboBoxProperties	TcxShellComboBox	An editor that combines a combo box and a Shell Tree View control.
TdxSparklineProperties	TdxSparklineEdit	An editor that visualizes data as lightweight charts without axes and labels.
TcxSpinEditProperties	TcxSpinEdit	A general-purpose numeric spin editor.
TcxTextEditProperties	TcxTextEdit	A simple single-line text editor.
TcxTimeEditProperties	TcxTimeEdit	A spin editor for time values.
TdxToggleSwitchProperties	TdxToggleSwitch	A toggle switch editor.
TdxTokenEditProperties	TdxTokenEdit	A token editor.
TcxTrackBarProperties	TcxTrackBar	A track bar editor with one slider.

Note

The RepositoryItem property has priority over Properties, PropertiesClass, and PropertiesClassName properties. These properties have no effect when the RepositoryItem property is specified.

Code Example: Shared In-Place Editor Settings

The following code example creates a progress bar repository item to assign a progress bar editor to two pivot grid fields:

Delphi

// ...
uses
  cxProgressBar, cxExtEditRepositoryItems;
// ...
var
  ARepositoryItem: TcxEditRepositoryProgressBar;
begin
  // Creates a repository item that defines a progress bar and stores its settings
  ARepositoryItem := cxEditRepository1.CreateItem(TcxEditRepositoryProgressBar) as TcxEditRepositoryProgressBar;
  ARepositoryItem.BarStyle := cxbsAnimation;
  ARepositoryItem.BeginColor := clLime;
  // Assigns the created repository item to two existing pivot grid fields
  cxDBPivotGridField1.RepositoryItem := ARepositoryItem;
  cxDBPivotGridField2.RepositoryItem := ARepositoryItem;
end;

C++

// ...
#pragma link "cxProgressBar"
#pragma link "cxExtEditRepositoryItems"
// ...
  TcxEditRepositoryProgressBar *ARepositoryItem;
  // Creates a repository item that defines a progress bar and stores its settings
  ARepositoryItem = dynamic_cast<TcxEditRepositoryProgressBar*>(cxEditRepository1->CreateItem(__classid(TcxEditRepositoryProgressBar)));
  ARepositoryItem->BarStyle = cxbsAnimation;
  ARepositoryItem->BeginColor = clLime;
  // Assigns the created repository item to two existing pivot grid fields
  cxDBPivotGridField1->RepositoryItem = ARepositoryItem;
  cxDBPivotGridField1->RepositoryItem = ARepositoryItem;

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:

ValueType[1]	ValueTypeClass[1]	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 pivot grid field regardless of the active data access mode.