TcxEditRepositoryNumericWheelPickerItem Class

A repository item that stores numeric wheel picker settings.

Declaration

TcxEditRepositoryNumericWheelPickerItem = class(
    TcxEditRepositoryItem
)

Remarks

A numeric wheel picker is a touch-friendly spin editor for integer values.

The TcxEditRepositoryNumericWheelPickerItem class overrides the Properties property that allows you to access and customize numeric wheel picker settings.

Edit Repository Items and Standalone Editors

Edit repository items are useful when you need to share the same settings between multiple editors of the same type. To accomplish this goal, you can assign the same edit repository item to RepositoryItem properties of all target editors.

Edit Repository Items and Container Controls

A container control item (such as a toolbar edit item or a column (or any other data item) in a Data Grid, Vertical Grid, or Tree List control) can embed an in-place editor shipped with the ExpressEditors Library. An in-place editor exists (and, therefore, has its own WinAPI handle) only when the target container control item is being edited. Otherwise, the container control item displays a static editor image for resource usage optimization.

Create a Numeric Wheel Picker Repository Item at Design Time

To create a numeric wheel picker repository item at design time, double-click a TcxEditRepository component to invoke its collection editor.

The collection editor dialog allows you to manage repository items. Click the Add… button to invoke a repository item creation dialog.

Select the NumericWheelPicker item and click the Ok button to create a numeric wheel picker repository item.

Create a Numeric Wheel Picker Repository Item in Code

The following code example creates a numeric wheel picker repository item, customizes editor settings, and assigns the created repository item to two existing unbound numeric wheel pickers:

Delphi

uses cxEdit, cxEditRepositoryItems;
// ...
var
  AWheelPickerRepositoryItem: TcxEditRepositoryNumericWheelPickerItem;
  ARepositoryItem: TcxEditRepositoryItem;
begin
  ARepositoryItem := cxEditRepository1.CreateItem(TcxEditRepositoryNumericWheelPickerItem);
  AWheelPickerRepositoryItem := ARepositoryItem as TcxEditRepositoryNumericWheelPickerItem;
  AWheelPickerRepositoryItem.Properties.Cyclic := True; // Loops the editor wheel
  AWheelPickerRepositoryItem.Properties.Min := 0; // Defines the minimum available value
  AWheelPickerRepositoryItem.Properties.Max := 25;  // Defines the maximum available value
  AWheelPickerRepositoryItem.Properties.LineCount := 5; // Defines the number of visible lines (positions)
  // Assigns the created repository item to two existing unbound numeric wheel picker editors
  dxNumericWheelPicker1.RepositoryItem := AWheelPickerRepositoryItem;
  dxNumericWheelPicker2.RepositoryItem := AWheelPickerRepositoryItem;
end;

C++

#include "cxEdit.hpp"
#include "cxEditRepositoryItems.hpp"
// ...
  TcxEditRepositoryNumericWheelPickerItem *AWheelPickerRepositoryItem;
  TcxEditRepositoryItem *ARepositoryItem;
  // ...
  ARepositoryItem = cxEditRepository1->CreateItem(__classid(TcxEditRepositoryNumericWheelPickerItem));
  AWheelPickerRepositoryItem = dynamic_cast<TcxEditRepositoryNumericWheelPickerItem*>(ARepositoryItem);
  AWheelPickerRepositoryItem->Properties->Cyclic = true; // Loops the editor wheel
  AWheelPickerRepositoryItem->Properties->Min = 0; // Defines the minimum available value
  AWheelPickerRepositoryItem->Properties->Max = 25; // Defines the maximum available value
  AWheelPickerRepositoryItem->Properties->LineCount = 5; // Defines the number of visible lines (positions)
  // Assigns the created repository item to two existing unbound numeric wheel picker editors
  dxNumericWheelPicker1->RepositoryItem = AWheelPickerRepositoryItem;
  dxNumericWheelPicker2->RepositoryItem = AWheelPickerRepositoryItem;

Numeric Wheel Picker Repository Item Deletion

To delete all numeric wheel picker repository items in a TcxEditRepository component, call its RemoveItems procedure and pass a reference to the TcxEditRepositoryNumericWheelPickerItem class as a parameter.

If you need to delete an individual numeric wheel picker repository item, release it directly in code (call the Free procedure in Delphi or use the delete keyword in C++Builder).

Inheritance

TObject

TPersistent

TComponent

TcxEditRepositoryItem

TcxEditRepositoryNumericWheelPickerItem