The Spin object allows you to add a spin-up and a spin-down button to increment and decrement dates for date entry.
The buttons can be added only on the right portion of the control, either inside or outside of the control area by using the Position property.
The properties of the Spin object can be set with the Button Property Page (TDBDate) at design time, and can be set with Visual Basic code at run time.
When using this object, the current field of the control in which the caret is placed will increment and decrement. If the caret is placed on a literal, the spin action will be ignored and not have any effect.
You can also increment past the maximum limit date (9999/12/31) and start again at the minimum limit date (100/1/1), or vice versa, by setting the Wrap property. Note that the maximum and the minimum limit dates may change according to the settings specified with the ValidateMode property. The amount of the number to spin will be determined by the Increment property.
Performing spin actions will cause values to carry on in any mode of the ValidateMode property. Also the valid ranges for the spin actions are equivalent when entering data defined in the individual modes, and NOT determined by the MaxDate and the MinDate properties. For the details, please refer to the ValidateMode property.
Up and Down arrow keys can be used together with the Spin object to increment and decrement values if not assigned to the Key object properties and when the SpinKeys property is set to True.
The SpinUp and SpinDown events will be fired when clicking on the Up/Down arrow spin buttons or when pressing the Up/Down arrow keys to increment/decrement the value within the current field.
 |
Note: When the control is set to the free format entry, all spin actions (mouse and keyboard) will be ignored. |
Clicking on the spin buttons will cause the focus to move into the edit control.
The Spin Object properties are listed in the following reference section: