Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxEditRepositoryTimeItem Class

#Declaration

Delphi
TcxEditRepositoryTimeItem = class(
    TcxEditRepositoryItem
)

#Remarks

A time editor allows users to change the selected time value digit directly or click spin buttons to adjust the displayed time value. Up and Down spin buttons increment and decrement the time value at the input caret position.

The TcxEditRepositoryTimeItem class overrides the Properties property that allows you to access and customize time editor 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.

VCL Tree List: An In-Place Date Editor

#Create a Time Editor Repository Item at Design Time

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

VCL Editors Library: An Edit Repository Collection Editor

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

VCL Editors Library: An Edit Repository Item Creation Dialog

Select the TimeEdit item and click the Ok button to create a time editor repository item.

#Create a Time Editor Repository Item in Code

The following code example creates a time editor repository item, customizes editor settings, and assigns the created repository item to two existing unbound time editors:

uses cxEdit, cxEditRepositoryItems;
// ...
var
  ATimeEditRepositoryItem: TcxEditRepositoryTimeItem;
  ARepositoryItem: TcxEditRepositoryItem;
begin
  ARepositoryItem := cxEditRepository1.CreateItem(TcxEditRepositoryTimeItem);
  ATimeEditRepositoryItem := ARepositoryItem as TcxEditRepositoryTimeItem;
  ATimeEditRepositoryItem.Properties.TimeFormat := tfHourMin; // Changes the current time format
  ATimeEditRepositoryItem.Properties.ShowDate := True; // Displays the date portion of a date/time value
  // Assigns the created repository item to two existing unbound time editors
  cxTimeEdit1.RepositoryItem := ATimeEditRepositoryItem;
  cxTimeEdit2.RepositoryItem := ATimeEditRepositoryItem;
end;

#Time Editor Repository Item Deletion

To delete all time editor repository items in a TcxEditRepository component, call its RemoveItems procedure and pass a reference to the TcxEditRepositoryTimeItem class as a parameter.

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

#Inheritance

See Also