Skip to main content

TcxCustomDateEdit Class

Serves as the base class for classes that implement date editors.

Declaration

TcxCustomDateEdit = class(
    TcxCustomPopupEdit
)

Remarks

This class introduces new properties and methods in additions to the capabilities of the TcxCustomPopupEdit in order to edit date data in a convenient way. To create an edit control to take advantage of the mask capabilities of TcxCustomDateEdit, use the TcxDateEdit or TcxDBDateEdit object.

In addition to entering dates via the dropdown calendar, a date editor allows a user to enter dates within an edit box in a number of ways depending on the Properties.InputKind property. The following table lists some of the possible formats recognized by a date editor in a system with default English (United States) regional settings.

InputKind value

Examples of dates

ikStandard

01/31

01/31/2002

9-Aug

August/09/2002

Smart input strings:

today; tomorrow; Sunday; now; bom

today–7; now+3

ikMask

01/31/2002

ikRegExpr

01/31/2002

Aug/09/2002

Smart input strings:

today; tomorrow; Sunday; now; bom

today–7; now+3

If the year is omitted in the ikStandard mode, the current year is assumed. The syntax in the ikRegExpr mode supports the auto-completion function. Also validation is performed and this restricts the user input.

Smart input strings are described in the SmartTextToDate topic. See the Using SmartTextToDate Function section to know how to expand possible constants.

Do not create instances of TcxCustomDateEdit. Use TcxCustomDateEdit as the base class when creating custom date editors. Properties and methods of TcxCustomDateEdit provide basic behavior that descendant classes inherit as well as behavior that components can override to customize the functionality.

See Also