TcxCustomGridTableItem.RepositoryItem Property

Specifies an edit repository item component for the grid table item.

Declaration

property RepositoryItem: TcxEditRepositoryItem read; write;

Property Value

Type	Description
TcxEditRepositoryItem	An edit repository item component.

Remarks

A grid table item uses an in-place editor shipped with the ExpressEditors Library to display and edit data. To assign an in-place editor to the table item, 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 in-place editor settings between multiple grid table items or change active editor settings in OnGetProperties and OnGetPropertiesForEdit event handlers.

Available Edit Repository Item Types

Every repository item type (a TcxEditRepositoryItem class descendant) defines the corresponding in-place editor type and stores its settings accessible through the Properties property. The following table lists all available edit repository items and corresponding in-place editor classes:

Repository Item Type	In-Place Editor	Description
TcxEditRepositoryBarCodeItem	TdxBarCode	A barcode control without user input functionality.
TcxEditRepositoryBlobItem	TcxBlobEdit	A Binary Large Object (BLOB) editor.
TcxEditRepositoryButtonItem	TcxButtonEdit	A single-line text editor with embedded buttons.
TcxEditRepositoryCalcItem	TcxCalcEdit	A single-line editor with a drop-down calculator window.
TcxEditRepositoryCheckBoxItem	TcxCheckBox	A check box editor with support for three states.
TcxEditRepositoryCheckComboBox	TcxCheckComboBox	A combo box editor that can display items with check boxes.
TcxEditRepositoryCheckGroupItem	TcxCheckGroup	An editor designed to display a set of check boxes.
TcxEditRepositoryColorComboBox	TcxColorComboBox	A color combo box editor.
TcxEditRepositoryColorEdit	TdxColorEdit	An editor designed to select a color in a color gallery embedded into a drop-down window.
TcxEditRepositoryComboBoxItem	TcxComboBox	A general-purpose combo box editor.
TcxEditRepositoryCurrencyItem	TcxCurrencyEdit	A numeric editor for currency values.
TcxEditRepositoryDateItem	TcxDateEdit	A date editor with a drop-down calendar.
TcxEditRepositoryDateTimeWheelPickerItem	TdxDateTimeWheelPicker	A date/time wheel picker editor.
TcxEditRepositoryExtLookupComboBoxItem	TcxExtLookupComboBox	A lookup editor that displays a Data Grid View in a drop-down window. Warning Do not use repository items to share settings between multiple lookup editors because these settings include data binding options. A repository item shared between multiple lookup editors binds them to the same dataset. This scenario may lead to data update and synchronization issues that are difficult to detect and identify.
TcxEditRepositoryExtLookupComboBoxItem	TcxExtLookupComboBox	A lookup editor that displays a Data Grid View in a drop-down window. Warning Do not use repository items to share settings between multiple lookup editors because these settings include data binding options. A repository item shared between multiple lookup editors binds them to the same dataset. This scenario may lead to data update and synchronization issues that are difficult to detect and identify.
TcxEditRepositoryFontNameComboBox	TcxFontNameComboBox	A combo box that allows users to switch between font typefaces.
TcxEditRepositoryFormattedLabel	TdxFormattedLabel	A formatted label editor without user input functionality.
TcxEditRepositoryHyperLinkItem	TcxHyperLinkEdit	A hyperlink editor that can execute custom commands.
TcxEditRepositoryImageComboBoxItem	TcxImageComboBox	A combo box whose items can display text and images.
TcxEditRepositoryImageItem	TcxImage	An editor designed to display images.
TcxEditRepositoryLabel	TcxLabel	An unformatted label editor without user input functionality.
TcxEditRepositoryLookupComboBoxItem	TcxLookupComboBox	A lookup combo box populated with values from a data source. Warning Do not use repository items to share settings between multiple lookup editors because these settings include data binding options. A repository item shared between multiple lookup editors binds them to the same dataset. This scenario may lead to data update and synchronization issues that are difficult to detect and identify.
TcxEditRepositoryLookupSparklineItem	TdxLookupSparklineEdit	A lookup sparkline editor.
TcxEditRepositoryMRUItem	TcxMRUEdit	A single-line text editor that displays a list of most recently used (MRU) items in a drop-down window.
TcxEditRepositoryMaskItem	TcxMaskEdit	A single-line text editor with support for input masks.
TcxEditRepositoryMemoItem	TcxMemo	A multi-line editor for plain text.
TcxEditRepositoryNumericWheelPickerItem	TdxNumericWheelPicker	A numeric value wheel picker editor.
TcxEditRepositoryPopupItem	TcxPopupEdit	A text editor that can embed a control in a drop-down window.
TcxEditRepositoryProgressBar	TcxProgressBar	A progress bar without user input functionality.
TcxEditRepositoryRadioGroupItem	TcxRadioGroup	A container for radio buttons.
TcxEditRepositoryRangeTrackBar	TdxRangeTrackBar	A track bar editor with two sliders that allow users to select a value range.
TcxEditRepositoryRatingControl	TdxRatingControl	A rating control.
TcxEditRepositoryRichItem	TcxRichEdit	A multi-line rich text editor.
TcxEditRepositorySparklineItem	TdxSparklineEdit	An editor that visualizes data as lightweight charts without axes and labels.
TcxEditRepositorySpinItem	TcxSpinEdit	A general-purpose numeric spin editor.
TcxEditRepositoryTextItem	TcxTextEdit	A simple single-line text editor.
TcxEditRepositoryTimeItem	TcxTimeEdit	A spin editor for time values.
TcxEditRepositoryToggleSwitchItem	TdxToggleSwitch	A toggle switch editor.
TcxEditRepositoryTokenItem	TdxTokenEdit	A token editor.
TcxEditRepositoryTrackBar	TcxTrackBar	A track bar editor with two sliders for value range selection.

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 two unbound Table View columns in a Data Grid control and uses a memo repository item to assign an in-place memo editor to them:

Delphi

uses cxEdit, cxEditRepositoryItems;
// ...
var
  AColumn1, AColumn2: TcxGridColumn;
  ARepositoryItem: TcxEditRepositoryMemoItem;
begin
  AColumn1 := cxGrid1TableView1.CreateColumn; // Creates a new unbound column
  AColumn2 := cxGrid1TableView1.CreateColumn; // Creates another unbound column
  // Creates a repository item that defines a memo editor and stores its settings
  ARepositoryItem := cxEditRepository1.CreateItem(TcxEditRepositoryMemoItem) as TcxEditRepositoryMemoItem;
  ARepositoryItem.Properties.ScrollBars := ssVertical; // Enables a vertical scroll bar
  ARepositoryItem.Properties.VisibleLineCount := 8; // Limits the number of simultaneously visible lines
  // Assigns the created repository item to both new columns
  AColumn1.RepositoryItem := ARepositoryItem;
  AColumn2.RepositoryItem := ARepositoryItem;
end;

C++

#include "cxEdit.hpp"
#include "cxEditRepositoryItems.hpp"
// ...
  TcxGridColumn *AColumn1, *AColumn2;
  TcxEditRepositoryMemoItem *ARepositoryItem;
  // ...
  AColumn1 = cxGrid1TableView1->CreateColumn(); // Creates a new unbound column
  AColumn2 = cxGrid1TableView1->CreateColumn(); // Creates another unbound column
  // Creates a repository item that defines a memo editor and stores its settings
  ARepositoryItem = dynamic_cast<TcxEditRepositoryMemoItem*>(cxEditRepository->CreateItem(__classid(TcxEditRepositoryMemoItem)));
  ARepositoryItem->Properties->ScrollBars = ssVertical; // Enables a vertical scroll bar
  ARepositoryItem->Properties->VisibleLineCount = 8; // Limits the number of simultaneously visible lines
  // Assigns the created repository item to both new columns
  AColumn1->RepositoryItem = ARepositoryItem;
  AColumn2->RepositoryItem = ARepositoryItem;

Default In-Place Editors

A grid table item uses the default in-place editor if Properties, PropertiesClass, PropertiesClassName, and RepositoryItem properties are unspecified. The grid table item uses one of the following in-place editors as default depending on DataBinding.ValueType and DataBinding.ValueTypeClass property values:

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