Accepting Numeric Input in a Given Range
Although you can set the InputMask property and include code in the Valid event to make sure that numeric values entered into text boxes fall within a given range, the easiest way to check the range of values is to use a spinner.
Using Spinners
You can use spinners to make it possible for users to make choices by "spinning" through values or directly typing the values in the spinner box.
Setting the Range of Values that Users Can Choose
Set the KeyboardHighValue and the SpinnerHighValue properties to the highest number you want users to be able to enter in the spinner.
Set the KeyboardLowValue and the SpinnerLowValue properties to the lowest number you want users to be able to enter in the spinner.
Decrementing a Spinner When the User Clicks the Up Button
Sometimes, if your spinner reflects a value like "priority," you want the user to be able to increase the priority from 2 to 1 by clicking the Up button. To cause the spinner number to decrement when the user clicks the Up button, set the Increment property to -1.
Spinning Through Non-Numeric Values
While the value of a spinner is numeric, you can use the Spinner control and a text box to make it possible for users to spin through multiple types of data. For instance, if you want a user to be able to spin through a range of dates, you could size the spinner so that only the buttons are visible and position a text box beside the spinner buttons. Set the Value property of the text box to a date and in the UpClick and DownClick events of the spinner, increment or decrement the date.
Tip
You can use the Windows API function GetSystemMetrics to set the width of your spinner so that only the buttons are visible and the buttons are the best width for the up and down arrow bitmap display.
Set the spinner's BorderStyle property to 0.
Include the following code in the Init of the spinner:
DECLARE INTEGER GetSystemMetrics IN Win32api INTEGER THIS.Width = GetSystemMetrics(2) && SM_CXVSCROLL
Common Spinner Properties
The following spinner properties are commonly set at design time.
Property |
Description |
|---|---|
How much to increment or decrement the value each time the user clicks the Up or Down buttons. |
|
The highest value that can be entered into the spinner text box. |
|
The lowest value that can be entered into the spinner text box. |
|
The highest value that the spinner will display when the user clicks the Up button. |
|
The lowest value that the spinner will display when the user clicks the Down button. |
See Also
Tasks
How to: Define User Input Characteristics
Concepts
Performing Specific Actions at Given Intervals
Controls and Objects Created in Earlier Versions
Reference
Controls for Allowing Specific Actions