The tables below describe the ELEMENT_TYPE_BUTTON specific parameters and
additional fields for the MSG_CONF_DASHBOARD_ELEMENT message.
Table 1. ELEMENT_TYPE_BUTTON Specific
Parameters| Parameter |
Value |
|---|
| ELEMENT_TYPE |
0x01 |
| Total data length of MSG_CONF_DASHBOARD_ELEMENT when
using ELEMENT_TYPE_BUTTON |
16 + length of button text (N) |
Table 2. Additional Data Fields to
MSG_CONF_DASHBOARD_ELEMENT for ELEMENT_TYPE_BUTTON| Field |
Size |
Values |
Description |
|---|
| Font size |
1 byte |
0-255 |
|
| Button text |
N bytes |
Null-terminated string, max. 20 bytes |
For toggle button text is selected by '/' delimited text
(<off text>/<on text>) |
| Toggle button |
1 byte |
- 0x00 = Normal button
- 0x01 = Toggle button
|
Change mode to toggle button. Button text is selected by
'/' delimited text field. |
Example
The picture below shows an example of two buttons; one normal button and
one toggle button. The element data fields for the example are shown in the tables
below the picture.
Note: The appearance of elements will vary with operating system version
and configuration.
Table 3. Button| Field |
Value |
|---|
| Z-index |
0 |
| X-coordinate |
30 |
| Y-coordinate |
30 |
| Width |
75 |
| Height |
25 |
| Element type |
0x01 |
| Font size |
12 |
| Button text |
“Button\0” |
| Toggle button |
0x00 |
Table 4. Toggle Button| Field |
Value |
|---|
| Z-index |
0 |
| X-coordinate |
30 |
| Y-coordinate |
70 |
| Width |
120 |
| Height |
25 |
| Element type |
0x01 |
| Font size |
12 |
| Button text |
“ON/OFF\0” |
| Toggle button |
0x01 |
