AN3128 datasheet(24/105 Pages) STMICROELECTRONICS

24 / 105 page

Multi-input embedded GUI library firmware

AN3128

24/105

Doc ID 16918 Rev 5

4.1.2

NewButton API global function

The button object is the most used and its graphical look changes temporarily during the

interaction between the touchscreen or the joystick. In fact there are two looks for the button

as well as for the majority of the others objects.

When the button is pressed, its “graphical look” changes for a few moments and then

returns to the starting aspect.

Inside the button, it's possible to insert a text Label, by which the button width itself depends.

The library automatically fits the width and places the text in the center.

Figure 6.

Button graphical layout

Table 7 describes the NewButton function:

Example:

/* Declares and initiates a Page Object */

GL_Page_TypeDef page1;

Create_PageObj( &page1 );

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

Page Object */

GL_PageControls_TypeDef* TestBtn = NewButton("TestBtn", "Test Button", TestBtnFunc);

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

TestBtn, &page1);

Once a button object instance is created using the NewButton function, the button object

itself provides all its features through its internal function pointers.

Table 7.

NewButton API function

Name

Description

Function name

NewButton

Function prototype

GL_PageControls_TypeDef* NewButton (char* oName, char* Label,

void* (*pEventHandler)(void))

Behavior description

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

Input parameter {x}

oName: object name

Label: Label on 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) 24 Page - STMicroelectronics

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

Enlace URL