<Stn:IntegerInputBox Name='Day'
Description
The IntegerInputBox control is used for input of integer values from the keyboard or from the software controlled buttons. The IntegerInputBox is usually used as sub-controls in the DateTimePicker control for the different input fields.
Properties
Alignment
| Description: | Defines where the rendering of text inside the IntegerInputBox shall start. If Alignment is set to “Near” the text will be placed toward the left edge of the IntegerInputBox. If it is set to “Far” the text will be positioned at the right edge of the IntegerInputBox. If “Center” is set as Alignment the text will be centred inside the IntegerInputBox. |
Format
| Description: | Defines how the value is formatted in the IntegerInputBox control. Usually set this to “D” followed by the number of digits to be displayed. If the value is 28 and Format is set to”D3”, “028” will be displayed in the IntegerInputBox control. |
Height
| Type: | Unsigned integer. Value range 0 – 128. |
| Description: | Defines the height of the integer input box on the display. |
Location
| Type: | String in format “X,Y” where X and Y are both unsigned integers. |
| Value: | Value range for X is 0 – 260
Value range for Y is 0 – 128. |
| Description: | Specifies where the integer input box shall be placed in relation to the parent control. If an integer input box is defined in a panel, the Location property will specify where inside the panel the control will be positioned. The physical location on the display will then depend on where the panel is placed (each panel also has a Location property) and where the image is placed. |
MaximumLength
| Type: | Unsigned integer value. |
| Description: | Maximum number of characters allowed as input when the value of the IntegerInputBox control is entered with the CWT 2115 keyboard. |
MaxValue
| Description: | Defines the maximum integer value allowed in the IntegerInputBox control. |
MinimumLength
| Type: | Unsigned integer value. |
| Description: | Minimum number of characters required when the value of the IntegerInputBox control is entered with the CWT 2115 keyboard. |
MinValue
| Description: | Defines the minimum integer value allowed in the IntegerInputBox control. |
Name
| Type: | A string of any length |
| Description: | The name of the IntegerInputBox control. It is important that the name is unique within a panel. |
TabOrder
| Description: | Defines the order of focus between multiple IntegerInputBox controls in a DateTimePicker control (see DateTimePicker (STN) ) when the button click-action OnSetNextInputControl is executed. The IntegerInputBox with TabOrder 1 will get into focus before an IntegerInputBox with TabOrder 2, and so on. |
Width
| Type: | Unsigned integer. Value range 0 – 260. |
| Description: | Defines the width of the integer input box on the display. |
WrapAroundValue
| Boolean: | true (default), false |
| Description: | If true the value entered will wrap around when MaxValue is exceeded. If false it will not accept trying to step over the MaxVaule |
Examples
The example defines an IntegerInputBox named “Day” that always displays 2 digits because Format is “D2” and has a value between 1 and 31. When text is entered with the CWT 2115 keyboard both the minimum and maximum number of digits allowed are set to "2".
<Stn:IntegerInputBox Name='Day' Location ='46,0' Width='14' Height='13'
MinimumLength='2' MaximumLength='2' MinValue='1' MaxValue='31'
TabOrder='3' Format='D2' Alignment='Center'/>
