AN3128 datasheet(26/105 Pages) STMICROELECTRONICS

26 / 105 page

Multi-input embedded GUI library firmware

AN3128

26/105

Doc ID 16918 Rev 5

4.1.4

NewSwitch API global function

The switch object or SwitchButton is very similar to the button object and actually contains

all its features, the only difference being that when this object is stimulated through the

touchscreen or the joystick, its state, and then its graphical look, change permanently until a

new press event.

The most obvious function of this object is to change the status of a Boolean/Binary variable

(0/1) and so enable/disable something.

Figure 8.

Switch graphical layout

Table 9 describes the NewSwitch function:

Example

/* Declares and initiates a Page Object */

GL_Page_TypeDef page1;

Create_PageObj( &page1 );

/* Declares and initiates a Switch Object and add it with specified coordinates to a

Page Object */

GL_PageControls_TypeDef* EnDisBtn = NewSwitch("EnDisBtn","Enable","Disable",MyFunc);

AddPageControlObj((uint16_t)((LCD_Width/10)*6),(uint8_t)((LCD_Height/9)*4),EnDisBtn,

&page1);

Once a switch object instance is created using the NewSwitch function, the switch object

itself provides all its features through its internal function pointers.

Figure 14, 15, 16, show, in detail, the switch object properties and methods which the final

application can use to interact with.

Table 9.

NewSwitch API function

Name

Description

Function name

NewSwitch

Function prototype

GL_PageControls_TypeDef* NewSwitch (char* oName, char* Label_1,

char* Label_2, void* (*pEventHandler)(void))

Behavior description

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

Input parameter {x}

oName: object name

Label_1: Label on not clicked switch button

Label_2: Label on clicked switch button

pEventHandler: pointer to function associated to its touch event

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

AN3128 Datasheet(PDF) 26 Page - STMicroelectronics

AN3128 Datasheet(HTML) 26 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