LbTranslateMsg Function

Microchip Graphics Library

Microchip Graphics Library
LbTranslateMsg Function
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

Microchip Graphics Library Version 3.06.02 - October 15, 2012
Copyright © 2012 Microchip Technology, Inc.  All rights reserved