The tables below describe the ELEMENT_TYPE_LABEL specific parameters and
additional fields for the MSG_CONF_DASHBOARD_ELEMENT message.
Table 1. ELEMENT_TYPE_LABEL
Parameters
| Parameter |
Value |
| ELEMENT_TYPE |
0x00 |
| Total data length of MSG_CONF_DASHBOARD_ELEMENT when
using ELEMENT_TYPE_LABEL |
26 + length of default text (N) |
Table 2. Additional Data Fields to
MSG_CONF_DASHBOARD_ELEMENT
| Field |
Size |
Values |
Description |
| Font size |
1 byte |
1-255 |
|
| Attribute |
1 byte |
- Bit 0: Bold ON/OFF
- Bit 1: Italic ON/OFF
|
|
| Horizontal alignment |
1 byte |
- 0 = Left
- 1 = Center
- 2 = Right
|
|
| Vertical alignment |
1 byte |
- 0 = Top
- 1 = Center
- 2 = Bottom
|
|
| Background transparency |
1 byte |
0 - 255 |
|
| Background color |
3 bytes |
0xRRGGBB |
RGB color of background |
| Foreground transparency |
1 byte |
0 - 255 |
|
| Foreground color |
3 bytes |
0xRRGGBB |
RGB color of background |
| Label text |
N bytes |
Null-terminated string max. 100 bytes |
|
Example
The picture below shows an example of two labels with the corresponding
parameters given in the tables below the picture.
Note: The appearance of elements will vary with operating system version
and configuration.
Table 3. Label1
| Field |
Value |
| Z-index |
0 |
| X-coordinate |
30 |
| Y-coordinate |
30 |
| Width |
200 |
| Height |
100 |
| Element type |
0x00 |
| Font size |
16 |
| Attribute |
0x01 |
| Horizontal alignment |
0 |
| Vertical alignment |
0 |
| Background transparency |
255 |
| Background color |
0x64FF64 |
| Foreground transparency |
255 |
| Foreground color |
0x000000 |
| Label text |
“Label1\0” |
Table 4. Label2
| Field |
Value |
| Z-index |
1 |
| X-coordinate |
90 |
| Y-coordinate |
70 |
| Width |
75 |
| Height |
25 |
| Element type |
0x00 |
| Font size |
12 |
| Attribute |
0x00 |
| Horizontal alignment |
1 |
| Vertical alignment |
1 |
| Background transparency |
100 |
| Background color |
0x646464 |
| Foreground transparency |
255 |
| Foreground color |
0x7C0000 |
| Label text |
“Label2\0” |
