C
WORD LbTranslateMsg( void * pObj, GOL_MSG * pMsg );
Overview
This function evaluates the message from a user if the message will affect the object or not. The table below enumerates the translated messages for each event of the touch screen and keyboard inputs.
Translated Message |
Input Source |
Events |
Description |
LB_MSG_TOUCHSCREEN |
Touch Screen |
Any |
Item is selected using touch screen. |
LB_MSG_MOVE |
Keyboard |
EVENT_KEYSCAN |
Focus is moved to the next item depending on the key pressed (UP or DOWN key). |
LB_MSG_SEL |
Keyboard |
EVENT_KEYSCAN |
LB_MSG_SEL – Selection is set to the currently focused item. |
OBJ_MSG_INVALID |
Any |
Any |
If the message did not affect the object. |
Input Parameters
Input Parameters |
Description |
GOL_MSG * pMsg |
Pointer to the message struct containing the message from the user interface. |
pLB |
The pointer to the object where the message will be evaluated to check if the message will affect the object. |
Returns
Returns the translated message depending on the received GOL message:
- LB_MSG_TOUCHSCREEN – Item is selected using touch screen.
- LB_MSG_MOVE – Focus is moved to the next item depending on the key pressed (UP or DOWN key).
- LB_MSG_SEL – Selection is set to the currently focused item.
Preconditions
none
Side Effects
none