Documentation  |   Table of Contents   |  < Previous   |  Next >  

7    AttentionMgr.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

In Palm OS Cobalt the Attention Manager uses a launch code to request services from your application; callback functions are no longer supported.

The card number parameter has been removed from a number of Attention Manager function prototypes.

Deleted APIs ^TOP^

Table 7.1  Deleted application-defined functions

Deleted API

Use instead

AttnCallbackProc()

Applications now receive notice of Attention Manager actions only via a launch code. Callbacks are no longer supported.

Modified APIs ^TOP^

Table 7.2  Modified functions

Modified API

Description of change

Boolean AttnForgetIt (DatabaseID, uint32_t)

The card number parameter has been removed.

status_t AttnGetAttention (DatabaseID, uint32_t, AttnLevelType, AttnFlagsType, uint16_t, uint16_t)

The card number parameter and the callback parameter have both been removed. Callbacks are no longer supported.

uint16_t AttnGetCounts (DatabaseID, uint16_t *, uint16_t *)

The card number parameter has been removed.

void AttnIterate (DatabaseID, uint32_t)

The card number parameter has been removed.

Boolean AttnUpdate (DatabaseID, uint32_t, AttnFlagsType *, uint16_t *, uint16_t *)

The card number parameter and the callback parameter have both been removed. Callbacks are no longer supported.

Table 7.3  Modified structures

Modified API

Description of change

AttnCommandArgsType

Padding bytes have been added to the various structures that make up this union.

AttnLaunchCodeArgsType

Padding bytes have been added to this structure.

Unchanged APIs ^TOP^

Table 7.4  Unchanged functions

AttnDoSpecialEffects()

AttnIndicatorEnable()

AttnIndicatorEnabled()

AttnListOpen()

Table 7.5  Unchanged structures

AttnNotifyDetailsType

Table 7.6  Unchanged types

AttnCommandType

AttnFlagsType

AttnLevelType

Table 7.7  Unchanged #defines

attnErrMemory

kAttnCommandCustomEffect

kAttnCommandDrawDetail

kAttnCommandDrawList

kAttnCommandGoThere

kAttnCommandGotIt

kAttnCommandIterate

kAttnCommandPlaySound

kAttnCommandSnooze

kAttnFlagsAllBits

kAttnFlagsAlwaysCustomEffect

kAttnFlagsAlwaysLED

kAttnFlagsAlwaysSound

kAttnFlagsAlwaysVibrate

kAttnFlagsCapabilitiesMask

kAttnFlagsCustomEffectBit

kAttnFlagsEverything

kAttnFlagsHasCustomEffect

kAttnFlagsHasLED

kAttnFlagsHasSound

kAttnFlagsHasVibrate

kAttnFlagsLEDBit

kAttnFlagsNoCustomEffect

kAttnFlagsNoLED

kAttnFlagsNoSound

kAttnFlagsNothing

kAttnFlagsNoVibrate

kAttnFlagsSoundBit

kAttnFlagsUserSettingsMask

kAttnFlagsUserWantsCustomEffect

kAttnFlagsUserWantsLED

kAttnFlagsUserWantsSound

kAttnFlagsUserWantsVibrate

kAttnFlagsUseUserSettings

kAttnFlagsVibrateBit

kAttnFtrCapabilities

kAttnFtrCreator

kAttnIndicatorHeight

kAttnIndicatorLeft

kAttnIndicatorTop

kAttnIndicatorWidth

kAttnLevelInsistent

kAttnLevelSubtle

kAttnListMaxIconWidth

kAttnListTextOffset