ELEMENT_TYPE_BUTTON

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