Documentation  |   Table of Contents   |  < Previous   |  Next >  

65    List.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

There is only one substantive change in the List APIs: the ListDrawDataFuncType() callback function takes one additional parameter, a pointer to the list in which the item is to be drawn.

Deleted APIs ^TOP^

Table 65.1  Deleted structures

Deleted API

Use instead

ListAttrType

Nothing. This structure was only used by the ListType structure, which is now completely private.

Modified APIs ^TOP^

Table 65.2  Modified structures

Modified API

Description of change

ListType

The contents of this structure are now completely private.

Table 65.3  Modified application-defined functions

Modified API

Description of change

void ListDrawDataFuncType (int16_t, RectangleType *, char **itemsText, struct ListType *)

The callback receives an additional parameter: a pointer to the list in which the item is to be drawn.

Unchanged APIs ^TOP^

Table 65.4  Unchanged functions

LstDrawList()

LstEraseList()

LstGetNumberOfItems()

LstGetSelection()

LstGetSelectionText()

LstGetTopItem()

LstGetVisibleItems()

LstHandleEvent()

LstMakeItemVisible()

LstNewList()

LstPopupList()

LstScrollList()

LstSetDrawFunction()

LstSetHeight()

LstSetListChoices()

LstSetPosition()

LstSetSelection()

LstSetTopItem()

Table 65.5  Unchanged types

ListDrawDataFuncPtr

ListPtr

Table 65.6  Unchanged #defines

noListSelection