ComponentOne True DBInput Pro 8.0
MaxDate Property (TDBCalendar)

MaxDate Property (TDBCalendar)

The MaxDate property is used in combination with the MinDate property to determine whether the specified date is within the proper range. The value set in the MaxDate property cannot be smaller than the date set in the MinDate property.

Syntax

control.MaxDate= variant

Read/Write at run time and design time.

Values

100/1/1 - 9999/12/31 (9999/12/31 is the default)

Remarks

Generally, the control allows you to enter any valid date while the control has the focus, including dates that exceed the MaxDate and MinDate property. There will be no range checking for the entered date. But as soon as you attempt to move the focus away, the InvalidRange event will be fired notifying the user that the entered date was out of range.

When modifying date values by changing the Value, Number or the Text properties, which are not within the proper range, this will cause an invalid value range error to occur. No events are fired, in this case.

When binding the control to a data source, if the retrieved values exceed the specified range, the DBError event will be fire, returning an error code - 1.

When the MultiSelect property is set to 0-None, validation will occur when the Value property is set, and dates will be validated when set in the Selections collections in multiple-selection mode.

When the Value property is set to Null, the range checking process will be ignored. A Null date value will not be accepted in the Selections collection property.

Value property will be automatically set to Null when the current date value does not fall within the maximum and minimum date range.

Navigation and scrolling are not available beyond the range of the MinDate and MaxDate values. However, if the range happens to start or end in the middle of a month or year, the dates out of range will be treated the same as the trailing days. Also, users will not be able to move the focus (change the value) to these days.

If the month columns and the month rows allow more months to be displayed in the control than the maximum and the minimum range specified, the months out of the range will be drawn using the trailing day attributes.

When reaching the minimum or the maximum value, the control will not allow wrapping to the first or the beginning.

 

 


Copyright (c) GrapeCity, inc. All rights reserved.

Product Support Forum  |  Documentation Feedback