ELEMENT_TYPE_BUTTON

The tables below describe the ELEMENT_TYPE_BUTTON specific parameters and additional fields for the MSG_CONF_DASHBOARD_ELEMENT message.

Table 5-57. ELEMENT_TYPE_BUTTON Specific Parameters
ParameterValue
ELEMENT_TYPE0x01
Total data length of MSG_CONF_DASHBOARD_ELEMENT when using ELEMENT_TYPE_BUTTON16 + length of button text (N)
Table 5-58. Additional Data Fields to MSG_CONF_DASHBOARD_ELEMENT for ELEMENT_TYPE_BUTTON
FieldSizeValuesDescription
Font size1 byte0-255
Button textN bytesNull-terminated string, max. 20 bytesFor toggle button text is selected by '/' delimited text (<off text>/<on text>)
Toggle button1 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.

: The appearance of elements will vary with operating system version and configuration.
Table 5-59. Button
FieldValue
Z-index0
X-coordinate30
Y-coordinate30
Width75
Height25
Element type0x01
Font size12
Button text“Button\0”
Toggle button0x00
Table 5-60. Toggle Button
FieldValue
Z-index0
X-coordinate30
Y-coordinate70
Width120
Height25
Element type0x01
Font size12
Button text“ON/OFF\0”
Toggle button0x01