TcxEditRepository.CreateItem(TcxEditRepositoryItemClass) Method
Creates a new repository item of the target type.
#Declaration
function CreateItem(ARepositoryItemClass: TcxEditRepositoryItemClass): TcxEditRepositoryItem; virtual;
#Parameters
Name | Type | Description |
---|---|---|
ARepository |
Tcx |
The reference to the target repository item class. Refer to the Remarks section for the full list of available repository item types. |
#Returns
Type | Description |
---|---|
Tcx |
The created repository item. To access all public API members of the created repository item, cast it to the corresponding edit repository class ( |
#Remarks
Call the CreateItem
function to create a repository item and set the current repository as the item owner. An owner component automatically destroys stored items when its destructor is called.
#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 |
---|---|---|
A barcode control without user input functionality. | ||
A Binary Large Object (BLOB) editor. | ||
A single-line text editor with embedded buttons. | ||
A single-line editor with a drop-down calculator window. | ||
A check box editor with support for three states. | ||
A combo box editor that can display items with check boxes. | ||
An editor designed to display a set of check boxes. | ||
A color combo box editor. | ||
An editor designed to select a color in a color gallery embedded into a drop-down window. | ||
A general-purpose combo box editor. | ||
A numeric editor for currency values. | ||
A date editor with a drop-down calendar. | ||
A date/time wheel picker editor. | ||
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. | ||
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. | ||
A combo box that allows users to switch between font typefaces. | ||
A formatted label editor without user input functionality. | ||
A hyperlink editor that can execute custom commands. | ||
A combo box whose items can display text and images. | ||
An editor designed to display images. | ||
An unformatted label editor without user input functionality. | ||
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. | ||
A lookup sparkline editor. | ||
A single-line text editor that displays a list of most recently used (MRU) items in a drop-down window. | ||
A single-line text editor with support for input masks. | ||
A multi-line editor for plain text. | ||
A numeric value wheel picker editor. | ||
A text editor that can embed a control in a drop-down window. | ||
A progress bar without user input functionality. | ||
A container for radio buttons. | ||
A track bar editor with two sliders that allow users to select a value range. | ||
A rating control. | ||
A multi-line rich text editor. | ||
An editor that visualizes data as lightweight charts without axes and labels. | ||
A general-purpose numeric spin editor. | ||
A simple single-line text editor. | ||
A spin editor for time values. | ||
A toggle switch editor. | ||
A token editor. | ||
A track bar editor with two sliders for value range selection. |
#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:
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;