Posted on

Exor | JMobile Text/Numeric Widget

In our video, we show how to add a text and numeric widget to your JMobile project. The text and numeric widgets have a lot of great functions such as; static label, dynamic label based on a tag, changing value using script, and many more. We will show you how to drag the widget into the HMI page area, change the color, add text, and link to a tag.

Text/Numeric Widget

The Text/Numeric widget has 4 different types of widgets that can be used in the HMI project. The Label, data field, hex field, and message field. The data field widget is the most commonly used widget and below is advanced information on the data field widget.

Data Field Widget

The most common widget is the data field widget that give the possibility to display value of tags.

Path: View> Toolbars and Docking Windows> Widget Gallery

Property Description
Value Tag that contain the information to display
Number FormatDisplay format
·         None – No restrictions (system decide the format to use)
·         Numeric – Numerical format. Decimal digits and Leading digits can be used to better define the
number format
·         hex – Hexadecimal format. Leading digits can be used to better define the number format
·         HEX – The same of “hex” format but using uppercase
·         scientific – Scientific format. Decimal digits can be used to better define the number format
·         SCIENTIFIC – The same of “scientific” format but using uppercase
·         Custom – Use the additional “Custom” parameter to better define the format to use (see the
below table)
Decimal Digits Number of decimal digits to show (not available on all format types)
Leading Digits Number of leading digits to show (not available on all format types)
Custom String that define the number format to use (available only when selected Number Format is CUSTOM)
KeypadKeypad type to pop up to edit the tab value:
·         None
·         Alphabetic, Numeric, Etc. Pop up a predefined keypad or a user keypad
·         Wheel Keypad will not be displayed . Wheel can be used to increment/decrement the numeric value
·         Macro Keypad will not be displayed . Keyboard macro can be used to enter keys
OnDataUpdate Action Commands list to execute any time the tag value changes

Custom Formats

In custom property, the allowed chars are “#” “.” “0” “h” “H” “e” “E”

Use the place holder characters to control the display of digits before and after the decimal place. Use the number sign (#) if you want to display only the significant digits in a number. This sign does not allow the display non-significant zeros. Use the numerical character for zero (0) if you want to display non-significant zeros when a number might have fewer digits than have been specified in the format code.

If a number has more digits to the left of the decimal point than there are placeholders in the format code, the extra digits are displayed. However, if a number has more digits to the right of the decimal point than there are placeholders in the format code, the number is rounded off to the same number of decimal places as there are placeholders.