The tables below describe the ELEMENT_TYPE_LABEL specific parameters and
additional fields for the MSG_CONF_DASHBOARD_ELEMENT message.
Table 5-53. ELEMENT_TYPE_LABEL
ParametersParameter | Value |
---|
ELEMENT_TYPE | 0x00 |
Total data length of MSG_CONF_DASHBOARD_ELEMENT when
using ELEMENT_TYPE_LABEL | 26 + length of default text (N) |
Table 5-54. Additional Data Fields to
MSG_CONF_DASHBOARD_ELEMENTField | 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.
: The appearance of elements will vary with operating system version
and configuration.
Table 5-55. Label1Field | 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 5-56. Label2Field | 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” |