Documentation  |   Table of Contents   |  < Previous   |  Next >  

91    Progress.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

The Progress APIs are only slightly modified from their Palm OS Garnet counterparts.

Deleted APIs ^TOP^

Table 91.1  Deleted functions

Deleted API

Use instead

PrgStartDialogV31()

PrgStartDialog()

Table 91.2  Deleted macros

Deleted API

Use instead

PrgUserCancel()

PrgUserCancel() (this is a function in Palm OS Cobalt).

Modified APIs ^TOP^

Table 91.3  Modified functions

Modified API

Description of change

void PrgUpdateDialog (ProgressPtr, status_t, uint16_t, const char *, Boolean)

The second parameter, err, formerly was a UInt16; it is now a status_t.

Table 91.4  Modified structures

Modified API

Description of change

PrgCallbackData

Three new fields have been added: bitmapDatabase, displaySkipBtn, and skipped. textLen is now a 32-bit value (previously it was 16 bits), and timeout is now a 64-bit value (previously it was 32 bits). Finally, various padding fields and spare bits have been added, and the fields within the structure has been re-ordered.

ProgressType

The contents of this structure, formerly exposed only for debugging purposes, are now completely opaque; structure fields can no longer be accessed directly.

Unchanged APIs ^TOP^

Table 91.5  Unchanged functions

PrgHandleEvent()

PrgStartDialog()

PrgStopDialog()

Table 91.6  Unchanged #defines

progressMaxButtonText

progressMaxMessage

progressMaxTitle

Table 91.7  Unchanged application-defined functions

PrgCallbackFunc()