The TcxDateEdit
component is an edit box with a drop-down calendar window that represents a date value. The drop-down calendar provides a convenient and natural way to input a date. It allows a user to select year, month and day values taking into account the number of days in the selected month and whether the selected year is a leap year. Also, the drop-down window can display buttons allowing the user to clear the date or to set the current date or date and time.
To obtain or set the date stored in the component, use the Date
property. The range of dates accepted by the component is specified by the Properties.MinDate
and Properties.MaxDate
properties.
When the user enters data into the component’s edit box depending on the Properties.InputKind
property, the value can be validated with the input mask or with a regular expression. Also the control can accept a set of textual values like now, Thursday or today-5 that are converted to a valid date value. See the SmartInput feature description for more information on this.
To adjust the appearance of the drop-down calendar, use the Properties.ArrowsForYear
, Properties.DateButtons
, Properties.WeekNumbers
and Properties.YearsInMonthList
properties.
The TcxDateEdit
component raises a number of events. For example, you can create an event handler for the OnEditValueChanged
event to process changes of the date value stored in the component.