Documentation  |   Table of Contents   |  < Previous   |  Next >  

74    NotifyMgr.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

Minor changes only. A few rarely-used notifications have been eliminated.

Deleted APIs ^TOP^

Table 74.1  Deleted functions

Deleted API

Use instead

SysNotifyBroadcastFromInterrupt()

SysNotifyBroadcast()

Table 74.2  Deleted structures

Deleted API

Use instead

SysNotifyDisplayResizedDetailsType

_WinResizedEventType (this structure accompanies a winResizedEvent).

SysNotifyInputAreaDrawingDetailsType

Nothing. The sysNotifyInputAreaDrawingEvent notification is not broadcast in Palm OS Cobalt.

SysNotifyInputAreaPendownDetailType

Nothing. The sysNotifyInputAreaPendownEvent notification is not broadcast in Palm OS Cobalt.

SysNotifySelectDayDetailsType

Nothing. The sysNotifySelectData notification is not broadcast in Palm OS Cobalt.

Table 74.3  Deleted #defines 

Deleted API

Use instead

sysNotifyDisplayResizedEvent

winResizedEvent. Rather than being concerned with the input area opening and closing, simply respond to changes in your window size as needed.

sysNotifyGsiDrawIndicator

Nothing. This notification is not broadcast in Palm OS Cobalt.

sysNotifyInputAreaDrawingEvent

Nothing. This notification is not broadcast in Palm OS Cobalt.

sysNotifyInputAreaPendownEvent

Nothing. This notification is not broadcast in Palm OS Cobalt.

sysNotifyNoDatabaseID

sysNotifyNoDatabaseH

sysNotifySelectDay

Nothing. This notification is not broadcast in Palm OS Cobalt.

Modified APIs ^TOP^

Table 74.4  Modified functions 

Modified API

Description of change

status_t SysNotifyBroadcastDeferred (SysNotifyParamType *, uint32_t)

The final parameter, paramSize, used to be declared as a 16-bit integer..

status_t SysNotifyRegister (DatabaseID, uint32_t, SysNotifyProcPtr, int32_t, void *, uint32_t)

The card number parameter has been removed. The priority parameter is now a 32-bit integer (formerly it was an 8-bit integer). An additional parameter has been added with which you specify the size of the user data.

status_t SysNotifyUnregister (DatabaseID, uint32_t, int32_t)

The card number parameter has been removed, and the priority parameter is now a 32-bit integer (formerly it was an 8-bit integer).

Table 74.5  Modified structures 

Modified API

Description of change

SysNotifyAppLaunchOrQuitType

Padding has been added. Note that the cardNo field remains in this structure.

SysNotifyDBChangedType

The dbName field has been renamed to name. The fields that identify the appInfo and sortInfo blocks are now handles, rather than LocalIDs. The cardNo field has been removed, and fields for the displayName and encoding have been added. Finally, the order of the fields in this structure has changed.

SysNotifyDBCreatedType

The dbName field has been renamed to name. The cardNo field has been removed. The resDB boolean that indicated whether or not the database was a resource database has been replaced by an attributes field that contains a number of database attributes. Finally, the order of the fields in this structure has changed.

SysNotifyDBDeletedType

The dbName field has been renamed to name. The cardNo field has been removed. The order of the fields in this structure has changed, and a reserved field has been added.

SysNotifyDBDirtyType

The dbName field has been renamed to name. Field have been added to hold the database's ID and attributes. The order of the fields in this structure has changed, and a reserved field has been added.

SysNotifyDBInfoType

The dbID field (database ID), formerly a LocalID, is now declared to be a MemHandle.

SysNotifyParamType

An additional padding field has been added.

Table 74.6  Modified #defines

Modified API

Description of change

#define sysNotifyDefaultQueueSize 100

In Palm OS Garnet this constant has a value of 30 for regular builds, 10 for debug builds.

Unchanged APIs ^TOP^

Table 74.7  Unchanged functions

SysNotifyBroadcast()

Table 74.8  Unchanged structures

SleepEventParamType

SysNotifyDisplayChangeDetailsType

SysNotifyLocaleChangedType

SysNotifyPenStrokeType

SysNotifyVirtualCharHandlingType

Table 74.9  Unchanged #defines 

cncNotifyProfileEvent

DBChangedFieldSetAppInfo

DBChangedFieldSetAttributes

DBChangedFieldSetBckUpDate

DBChangedFieldSetCrDate

DBChangedFieldSetCreator

DBChangedFieldSetModDate

DBChangedFieldSetModNum

DBChangedFieldSetName

DBChangedFieldSetSortInfo

DBChangedFieldSetType

DBChangedFieldSetVersion

sysExternalConnectorAttachEvent

sysExternalConnectorDetachEvent

sysNotifyAntennaRaisedEvent

sysNotifyAppLaunchingEvent

sysNotifyAppQuittingEvent

sysNotifyBroadcasterCode

sysNotifyCardInsertedEvent

sysNotifyCardRemovedEvent

sysNotifyDBChangedEvent

sysNotifyDBCreatedEvent

sysNotifyDBDeletedEvent

sysNotifyDBDirtyEvent

sysNotifyDeleteProtectedEvent

sysNotifyDeviceUnlocked

sysNotifyDisplayChangeEvent

sysNotifyEarlyWakeupEvent

sysNotifyEventDequeuedEvent

sysNotifyForgotPasswordEvent

sysNotifyGotUsersAttention

sysNotifyHelperEvent

sysNotifyIdleTimeEvent

sysNotifyInsPtEnableEvent

sysNotifyIrDASniffEvent

sysNotifyKeyboardDialogEvent

sysNotifyLateWakeupEvent

sysNotifyLocaleChangedEvent

sysNotifyMenuCmdBarOpenEvent

sysNotifyNetLibIFMediaEvent

sysNotifyNormalPriority

sysNotifyPhoneEvent

sysNotifyPOSEMountEvent

sysNotifyProcessPenStrokeEvent

sysNotifyResetFinishedEvent

sysNotifyRetryEnqueueKey

sysNotifySecuritySettingEvent

sysNotifySleepNotifyEvent

sysNotifySleepRequestEvent

sysNotifySyncFinishEvent

sysNotifySyncStartEvent

sysNotifyTimeChangeEvent

sysNotifyVersionNum

sysNotifyVirtualCharHandlingEvent

sysNotifyVolumeMountedEvent

sysNotifyVolumeUnmountedEvent

sysSleepAutoOff

sysSleepPowerButton

sysSleepResumed

sysSleepUnknown

Table 74.10  Unchanged application-defined functions

SysNotifyProcPtr()