Documentation  |   Table of Contents   |  < Previous   |  Next >  

14    Category.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

A handful of functions have a new parameter identifying a resource database from which certain strings should be taken, and a number of deprecated APIs have been removed.

Deleted APIs ^TOP^

Table 14.1  Deleted functions 

Deleted API

Use instead

CategoryCreateListV10()

CategoryCreateList()

CategoryEditV10()

CategoryEdit()

CategoryEditV20()

CategoryEdit()

CategoryFreeListV10()

CategoryFreeList()

CategorySelectV10()

CategorySelect()

Modified APIs ^TOP^

Table 14.2  Modified functions 

Modified API

Description of change

void CategoryCreateList (DmOpenRef, ListType *, uint16_t, Boolean, Boolean, uint8_t, DmOpenRef, uint32_t, Boolean)

Contains an additional parameter identifying the resource database from which the text of the Edit Categories list item is taken.

Boolean CategoryEdit (DmOpenRef, uint16_t *, DmOpenRef, uint32_t, uint8_t)

Contains an additional parameter identifying the resource database from which the dialog's title is taken.

void CategoryInitialize (AppInfoPtr, DmOpenRef, uint16_t)

Contains an additional parameter identifying the resource database from which the application info strings are taken.

Boolean CategorySelect (DmOpenRef, const FormType *, uint16_t, uint16_t, Boolean, uint16_t *, char *, uint8_t, DmOpenRef, uint32_t)

Contains an additional parameter identifying the resource database from which the text of the Edit Categories list item is taken.

Unchanged APIs ^TOP^

Table 14.3  Unchanged functions 

CategoryFind()

CategoryGetName()

CategoryFreeList()

CategoryGetNext()

CategorySetName()

CategorySetTriggerLabel()

CategoryTruncateName()

Table 14.4  Unchanged structures 

AppInfoType

Table 14.5  Unchanged types 

AppInfoPtr

Table 14.6  Unchanged #defines 

categoryDefaultEditCategoryString

categoryHideEditCategory