AN3128 datasheet(28/105 Pages) STMICROELECTRONICS

28 / 105 page

Multi-input embedded GUI library firmware

AN3128

28/105

Doc ID 16918 Rev 5

4.1.6

NewRadioButtonGrp API global function

The radio button (sometimes called the option button) is a special kind of button that allows

the user to choose only one of a predefined set of alternatives. Its name derives from the old

car radio, where this button was used to select the preset stations. The major difference with

the ordinary button is that the radio buttons are arranged in groups where the group acts as

a big switchboard. In a group, only one radio button must be selected at most. Then, if in a

group, the first radio button is in the selected state, and suddenly the second radio button is

pressed, the first one must be immediately released going back to the normal state, and the

second passes to the selected state.

Figure 9.

Radio button graphical layout

Table 11 describes the NewRadioButtonGrp function:

Example:

/* Declares and initiates a RadioButtonGrp Object */

GL_RadioButtonGrp_TypeDef* RadioButtonGrp = NewRadioButtonGrp("RadioButtonGrp");

4.1.7

AddRadioOption API global function

Table 12 describes the AddRadioOption function:

Table 11.

NewRadioButtonGrp API function

Name

Description

Function name

NewRadioButtonGrp

Function prototype

GL_RadioButtonGrp_TypeDef* NewRadioButtonGrp (char* oName)

Behavior description

Create and initialize a new RadioButtonGrp object (a C structure)

Input parameter {x}

oName: object name

Output parameter {x}

None

Return value

The created object pointer or null if the object cannot be created

Required preconditions

None

Called functions

No API/HAL layer functions

Table 12.

AddRadioOption API function

Name

Description

Function name

AddRadioOption

Function prototype

GL_PageControls_TypeDef* AddRadioOption

(GL_RadioButtonGrp_TypeDef* pThis, char* Label, void*

(*pEventHandler)(void))

Behavior description

Create and initialize a new Label Object (a C structure)

AN3128 Datasheet(PDF) 28 Page - STMicroelectronics

AN3128 Datasheet(HTML) 28 Page - STMicroelectronics

Html Pages

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 ...More

Datasheet Download

Link URL