Label
The Label View is very similar to the , but is displayed as static text and is not directly editable.
This is useful for developing advanced configuration/control panels.
The label text is processed to replace $[Units Name] with the units of the specified user Units (e.g. '$[Load Units]' might become kPa, and '$[Speed Units]' might become mph, depending on the user units selection).
If you need to display something beginning with '$[' then start it with a double sigil, '$$'. Any double sigil will be converted to a single character.
When accessed via scripts, the label text can be accessed by the 'text' property:
var label = window.findViewByID("my_label");
print(label.text);
label.text = "Bingo";View Properties
Properties editable via the properties editor.
| Property | Script ID | Description |
|---|---|---|
| Title | title |
The title of the window. |
| Script ID | id |
The scripting ID of the window. Can be used as an alternative to the title for searching for windows from scripts. |
| Tool Tip | tooltip |
Window tool tip. |
| Display Units | display_units_text |
Show units after the number on the view. |
| Display Units (Label) | display_units_label |
Show units after the label on the view. |
| Prefix Text | prefix_text |
Text to display before the value. |
| Postfix Text | postfix_text |
Text to display after the value. |
| Limits | limits |
Set up alarm limits for this gauge. |
| Show Value | show_value |
|
| Show Label | show_label |
|
| Label Font | label_font |
|
| Value Font | value_font |
|
| Value Height % | value_height_percent |
A value of zero disables auto font size fitting if Value Height Max is set |
| Value Height Max [dp] | value_height_max_dp |
Maximum font height of the value text, in device pixels |
| Label Height % | label_height_percent |
|
| Label Height Max [dp] | label_height_max_dp |
Maximum font height of the label, in device pixels |
| Label Text | label_text |
|
| Label Align | label_align |
|
| Label Vertical Align | label_valign |
|
| Value Align | value_align |
|
| Value Vertical Align | value_valign |
|
| Low Limit Text | low_limit_text |
|
| High Limit Text | high_limit_text |
|
| Value Override Text | value_text |
|
| Max length Text | max_length_text |
Leave blank for auto |
| Background | bg_colour |
Background colour |
| Text | text_colour |
Text colour |
| Alarm Low Background | alarm_low_bg_colour |
Alarm Lower Limit Background colour |
| Alarm Low Text | alarm_low_text_colour |
Alarm Lower Limit Text colour |
| Alarm High Background | alarm_high_bg_colour |
Alarm Upper Limit Background colour |
| Alarm High Text | alarm_high_text_colour |
Alarm Upper Limit Text colour |
| Input Value | parameter |
The source of the value that will be displayed by the gauge. |
| Update Rate | update_rate |
Rate at which the input value is requested from the ECU. |
| Decimal Places | decimal_places |
Set to -1 for auto |