Numeric field

An integer field allows the user to enter an integer number (whole numbers, positive or negative, with no fractional component).

Option Description
Default Value The default value for the field which appears on the device panel.
Required Select this check box to require that a value must be entered into this field before a scan can be initiated. If a default value is specified, it satisfies this requirement.
Maximum Value Specifies the maximum value that may be entered into the field. For example, a value of “50” in this element would allow all values less than or equal to 50.
Minimum Value Specifies the minimum value that may be entered into the field. For example, a value of “10” in this element would allow all values greater than or equal to 10.
Enable Grouping Select this check box to group digits in the nonfractional part of a number. For example, when this check box is selected, the number one million is shown as “1,000,000”. When this check box is cleared, it is shown as “1000000”.
Group Separator Specifies the character to be used when grouping the digits of a number. For example, the number “one million” is displayed as “1.000.000” if the grouping separator is set to a period (.). This setting is ignored if the Enable Grouping check box is cleared.
Grouping Digits Specifies the number of fractional digits that will be displayed. For example, the number 10.25 has two fractional digits. The default number of digits is “2”.
Decimal Places Specifies the number of digits after decimal point.
Decimal Separator Specifies the character to be used when separating the non-fractional part of a number from the fractional part. For example, 10,25 if the decimal separator is set to a comma (,) or 10.25 if the decimal separator is set to a period (.). This setting is ignored within the scope of an integer field.
Format String The format string allows numbers to be formatted in custom ways.

Specifying Custom Format Strings

The following characters are used in the Format String box to format a numeric string.

String Description
0 The zero placeholder indicates that if a value exists in the digit of the number to be displayed it should be used; otherwise, a zero will be displayed.
# The digit placeholder indicates that if a value exists in the digit of the number to be displayed it should be used; otherwise, no character will be displayed.
. The decimal point indicates the position of the decimal character. The actual character used, however, is specified first by the number format parameters described in section 5.7.3.1, “Number Format” and then by the default parameters for the current locale.
, The grouping separator indicates the number of digits that should be grouped together in the whole part of the number. For example, “#,###0.00” indicates that there should be four grouping digits used. The actual character used is specified first by the number format parameters described in section 5.7.3.1, “Number Format” and then by the default parameters for the current locale.
; Used for separating the positive representation from the negative representation. The positive number format precedes the negative number format. In the absence of a negative format, a negative sign “-” is added—preceding all characters.

All other characters are not parsed. A few examples:

The format “$#,##0.00;$(#,##0.00)” yields the following (note that the dollar sign “$” is not a special character and is interpreted literally):

  • 1 -> $1.00
  • 5654.35 -> $5,654.34
  • -6000.34 -> $(6,000.34)

The format “0.0%” yields the following (the percentage sign “%” is not a special character):

  • 6.5 -> 6.5%
  • -0.5 -> -0.5%
  • 0 -> 0.0%

Additional characters may only be added to the beginning or end of the format string.