List Box Functions

 

Name 

Description 

 

LbCreate 

This function creates a LISTBOX object with the parameters given. It automatically attaches the new object into a global linked list of objects and returns the address of the object. 

 

LbDraw 

This function renders the object on the screen using the current parameter settings. Location of the object is determined by the left, top, right and bottom parameters. The colors used are dependent on the state of the object. The font used is determined by the style scheme set.
The text or items drawn in the visible window of the list box is dependent on the alignment set.
When rendering objects of the same type, each object must be rendered completely before the rendering of the next object is started. This is to avoid incomplete object rendering. 

 

LbAddItem 

This function allocates memory for the LISTITEM and adds it to the list box. The newly created LISTITEM will store the location of pText, pBitmap and other parameters describing the added item. 

 

LbDelItem 

This function removes an item from the list box and frees the memory used. 

 

LbChangeSel 

This function changes the selection status of an item in the list box. If the item is currently selected, it resets the selection. If the item is currently not selected it is set to be selected. 

 

LbGetSel 

This function searches for selected items from the list box. A starting position can optionally be given. If starting position is set to NULL, search will begin from the first item list. It returns the pointer to the first selected item found or NULL if there are no items selected. 

 

LbGetFocusedItem 

This function returns the index of the focused item in the list box. 

 

LbSetFocusedItem 

This function sets the focus for the item with the given index. 

 

LbDelItemsList 

This function removes all items from the list box and frees the memory used. 

 

LbMsgDefault 

This function performs the actual state change based on the translated message given. The following state changes are supported:  

 

LbTranslateMsg 

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.