TcxEditRepository.RemoveItems(TcxEditRepositoryItemClass) Method
Deletes all edit repository items of a specified type.
Declaration
procedure RemoveItems(AItemClass: TcxEditRepositoryItemClass);
Parameters
| Name | Type | Description |
|---|---|---|
| AItemClass | TcxEditRepositoryItemClass | The reference to the target edit repository item class. Refer to the Remarks section for the full list of available options. |
Remarks
Call the RemoveItems function to delete all stored repository items of the same type. Pass a reference to the target repository item class as the AItemClass parameter.
- Available Edit Repository Item Types
- B — Bar Code/BLOB/Button Editors
- C — Calculator | Check Box | Combo Box | …
- D — Date & Time Editors
- F — Font Name Combo Box & Formatted Label
- H — Hyperlink Editor
- I — Image Combo Box & Image Editors
- L — Label
- L — Lookup Editors
- M — Mask/Memo/MRU Editors
- N — Numeric Wheel Picker Editor
- P — Pop-Up Editor & Progress Bar
- R — Radio Group | Range Track Bar | RTF Editor | …
- S — Sparkline & Spin Editors
- T — Text Editor | Time Editor | Toggle Switch | …
- Code Example: Delete All Memo Editor Repository Items
- Other Repository Item Deletion Options
Available Edit Repository Item Types
Every repository item type defines the corresponding in-place editor type and stores editor settings. You can access and modify these settings using the TcxEditRepositoryItem.Properties property.
The following table lists all available edit repository item types (terminal TcxEditRepositoryItem class descendants) and corresponding in-place editor classes:
B — Bar Code/BLOB/Button Editors
| Repository Item Class | 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. |
C — Calculator | Check Box | Combo Box | …
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| 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. |
D — Date & Time Editors
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositoryDateItem | TcxDateEdit | A date editor with a drop-down calendar. |
| TcxEditRepositoryDateTimeWheelPickerItem | TdxDateTimeWheelPicker | A date/time wheel picker editor. |
F — Font Name Combo Box & Formatted Label
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositoryFontNameComboBox | TcxFontNameComboBox | A combo box that allows users to switch between font typefaces. |
| TcxEditRepositoryFormattedLabel | TdxFormattedLabel | A formatted label without user input functionality. |
H — Hyperlink Editor
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositoryHyperLinkItem | TcxHyperLinkEdit | A hyperlink editor that can execute custom commands. |
I — Image Combo Box & Image Editors
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositoryImageComboBoxItem | TcxImageComboBox | A combo box designed to display both text and images in items. |
| TcxEditRepositoryImageItem | TcxImage | An editor designed to display and edit images. |
L — Label
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositoryLabel | TcxLabel | An unformatted label without user input functionality. |
L — Lookup Editors
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.
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositoryExtLookupComboBoxItem | TcxExtLookupComboBox | A lookup editor that displays a Data Grid View in a drop-down window. |
| TcxEditRepositoryLookupComboBoxItem | TcxLookupComboBox | A lookup combo box populated with values from a data source. |
| TcxEditRepositoryLookupSparklineItem | TdxLookupSparklineEdit | A lookup sparkline editor. |
M — Mask/Memo/MRU Editors
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositoryMaskItem | TcxMaskEdit | A single-line text editor with support for input masks. |
| TcxEditRepositoryMemoItem | TcxMemo | A multi-line editor for plain text. |
| TcxEditRepositoryMRUItem | TcxMRUEdit | A single-line text editor that displays a list of most recently used (MRU) items in a drop-down window. |
N — Numeric Wheel Picker Editor
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositoryNumericWheelPickerItem | TdxNumericWheelPicker | A numeric value wheel picker editor. |
P — Pop-Up Editor & Progress Bar
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositoryPopupItem | TcxPopupEdit | A text editor that can embed a control in a pop-up window. |
| TcxEditRepositoryProgressBar | TcxProgressBar | A progress bar without user input functionality. |
R — Radio Group | Range Track Bar | RTF Editor | …
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositoryRadioGroupItem | TcxRadioGroup | A container for radio buttons. |
| TcxEditRepositoryRangeTrackBar | TdxRangeTrackBar | A track bar editor with two sliders designed to select a range of values. |
| TcxEditRepositoryRatingControl | TdxRatingControl | A rating editor. |
| TcxEditRepositoryRichItem | TcxRichEdit | A multi-line rich text editor. |
S — Sparkline & Spin Editors
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| TcxEditRepositorySparklineItem | TdxSparklineEdit | An editor designed to visualize data as lightweight charts without axes and labels. |
| TcxEditRepositorySpinItem | TcxSpinEdit | A general-purpose numeric spin editor. |
T — Text Editor | Time Editor | Toggle Switch | …
| Repository Item Class | In-Place Editor | Description |
|---|---|---|
| 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. |
Code Example: Delete All Memo Editor Repository Items
The following code example deletes all repository items that define a memo editor and its settings.
uses cxEdit, cxEditRepositoryItems;
// ...
cxEditRepository1.RemoveItems(TcxEditRepositoryMemoItem);
Other Repository Item Deletion Options
You can call the Clear procedure to delete all stored repository items. If you need to delete an individual repository item, release it directly in code (call the Free procedure in Delphi or use the delete keyword in C++Builder).