| Reference > TDBCalendar Control > TDBCalendar Control Properties > Value Property (TDBCalendar) |
The Value property returns or sets a selected date for single selection mode, or the focus rectangle for a date in multi-selection mode.
TDBCalendar.Value= variant
Read/Write at run time and design time.
System date is the default
If MultiSelect property is set to 0-None, the calendar control is in single selection mode, and only one date item can be selected at a time. The Value property will return the date selected and not the date with the focus rectangle.
If MultiSelect property is set to 1-Simple, the focus rectangle will be located on the date specified with the Value property, and all the selected dates will be added to the SelectionsCollection.
When the Value property is set to Null, no dates will be selected (only in single selection) and the focus rectangle will be placed on the date retrieved from the system. However, if the current system date is out of the minimum and the maximum range, then either the MinDate or the MaxDate close date value will be activated. Note that the Value property will be automatically set to Null when resetting the maximum or the minimum date range out the current value using the MaxDate and the MinDate properties.
This is the default property of the TDBCalendar control.
The Value property can only be bound with the database when MultiSelect property is set to 0-None.
Note that a date with the focus rectangle and a selected date are completely two different things.
Null value is not a valid date that can be converted to a date, but can be used as a Variant subtype, indicating that a variable or a property contains no valid data.
When the StartOfMonth property is set to 0-Default, changing the Value property will cause the new month to display on the upper left position only if the new value does not contain in the current view. However, if the value already exist within the current view, the upper left month will not be changed and the specified date will be selected.