Number Edit
The Number Edit View provides means to enter in a floating point number and access it from scripts.
The value has no effect on the ECU and is stored in the tabs file, not in the calibration as with options/tables/maps.
To access the value of a Number Edit View on the same tab / Group:
By ID (see the ID property of the Number Edit View):
var edit = window.findViewByID("my\_edit\_box");
print(edit.value);
edit.value = 10;
By Title (see the Title property of the Number Edit View):
var edit = window.findViewByTitle("My Edit Box");
print(edit.value);
edit.value = 10;
The ID method is slightly more robust than the title method in that any renaming of the window title will not break dependent scripts.
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 |