L-VIS User Manual
105
LOYTEC
Version 6.2
LOYTEC electronics GmbH
Specify significant digits:
This option toggles between definition of
integer and
fractional digits
, and definition of the
range of significant digits
. Defining a
minimum number of desired integer digits and a fixed number of fractional digits
leads to an output where the decimal point is always at the same location. This
makes the output suitable for fixed layouts like tabular display of multiple values,
but it limits the range of displayable values. Specifying a range for the number of
significant digits to display leads to an output where the decimal point changes
position or may disappear completely, depending on the value displayed. This
makes it unsuitable for fixed layouts, but it provides a very flexible way to
display just about any number, no matter if it is a large number like 20136 or a
very small number like 0.00124.
Use grouping:
Depending on the locale, large numbers may be grouped by
certain separator characters for better readability. In many western locales,
groups of 10
3
are common, but certain locales may use groups of 10
4
instead.
Always add sign character:
This option requests that positive numbers should
be prefixed with a
+
character explicitly, while the default positive number prefix
is usually not set (no prefix added).
Append data point unit string:
This option will include a suitable place holder
tag which is replaced by the effective engineering unit of the connected data
point during run time.
Unit Width:
Desired padding for the unit string, to facilitate column alignment
even when the unit string changes due to selection of a different unit system at
run time. The given number of pixels will be reserved for the unit string as a
minimum width. Should the unit string be wider, the width will be adjusted to fit
the string.
Local aware number controls expect the control text to contain a
${value}
placeholder,
which will be replaced by the formatted value. Since each number control only handles one
value, there should be only one value placeholder. In case there are multiple occurrences of
${value} in the control text, each occurrence will be replaced by the same formatted value.
9.5.4.2 C-Style Format
If locale aware formatting is not supported by the target device, or the option is turned off
for the control, the standard C-style format is used. A separate
Format String Wizard
property page is available to easily create a correct format string by setting a few options:
Style:
The basic style of the value display can be selected from this list. Each style
has an example to show how it would look like. The styles
dynamic 1
and
dynamic
2
automatically switch between the floating point format and one of the two
scientific formats (1 or 2), based on the value and the selected precision.
Field Width:
This value defines the
minimum
desired number of characters to
output, including sign, leading zero, decimal point and any other characters which
are part of the displayed number. If the number needs more characters to display
than specified here, the field width will be extended as needed, so that no
characters are cut off.
Precision:
This value specifies the desired number of digits following the decimal
point. The displayed value is rounded to fit the desired precision. For example, the
value 2.86 is displayed as 2.9 if a precision of 1 is used and as 3 if a precision of 0
is used.
Zero Padding:
This option causes the converted number to be padded with
leading zeros rather than blanks, if the number is shorter than the minimum
specified field width. This option has no effect, if the option
left justified
is used.
