AN3128 datasheet(27/105 Pages) STMICROELECTRONICS

27 / 105 page

AN3128

Multi-input embedded GUI library firmware

Doc ID 16918 Rev 5

27/105

4.1.5

NewIcon API global function

This object allows the user to show an arbitrary image on the LCD, stored in the Flash

memory of the MCU, and associate the press event of the image itself through the

touchscreen or the joystick.

Table 10 describes the NewIcon function:

Example:

/* Declares and initiates a Page Object */

GL_Page_TypeDef page1;

Create_PageObj( &page1 );

/* Declare and initiate a Icon Object and add it with specified coordinates to a Page

Object */

GL_PageControls_TypeDef* MyIcon = NewIcon ("MyIcon", NULL, 90, 90, NullFunc);

AddPageControlObj( (uint16_t)((LCD_Width/2)+45),(uint8_t)((LCD_Height/2)+45),MyIcon,

&page1 );

Once an icon object instance is created using the icon function, the icon object itself

provides all its features through its internal function pointers.

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

application can use to interact with.

Table 10.

NewIcon API function

Name

Description

Function name

NewIcon

Function prototype

GL_PageControls_TypeDef* NewIcon (char* oName, GL_uint8_t*

Image_PTR, GL_uint16_t Width, GL_uint8_t Height, void*

(*pEventHandler)(void))

Behavior description

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

Input parameter {x}

oName: object name

Image_PTR: icon image pointer

Width: image width

Height: image height

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) 27 Page - STMicroelectronics

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