ELEMENT_TYPE_RADIO

The tables below describe the ELEMENT_TYPE_RADIO specific parameters and additional fields for the MSG_CONF_DASHBOARD_ELEMENT message. This element generates a group of radio buttons where only one option can be selected. Initially, the first option is selected.

Table 1. ELEMENT_TYPE_RADIO Specific Parameters
Parameter Value
ELEMENT_TYPE 0x08
Total data length of MSG_CONF_DASHBOARD_ELEMENT when using ELEMENT_TYPE_RADIO 17 + length of text fields (N)
Table 2. Additional Data Fields to MSG_CONF_DASHBOARD_ELEMENT for ELEMENT_TYPE_RADIO
Field Size Values Description
Font size 1 byte 0-100  
Number of items 1 byte 1-10  
Orientation 1 byte
  • 0 = Horizontal
  • 1 = Vertical
  
Text fields N bytes Null-terminated string max. 20 bytes '/' separated option list

Example

The picture below shows an example of radio button group with three buttons. The corresponding element data fields are given in the table below the picture.

Note: The appearance of elements will vary with operating system version and configuration.
Table 3. Radio Button Group
Field Value
Z-index 0
X-coordinate 20
Y-coordinate 20
Width 100
Height 100
Element type 0x08
Font size 16
Number of radio buttons 3
Orientation 1
Text fields “Op 1/Op 2/Op 3\0”
Parent topic: MSG_CONF_DASHBOARD_ELEMENT