The changes to the System Event Manager arise primarily from the following:
- Palm OS Cobalt doesn't have "silkscreen buttons." The functionality provided by those buttons can be found in the Palm OS Cobalt status bar and in individual pinlets.
- Palm OS Cobalt doesn't have separate low-level event queues for key presses and digitizer strokes. To ease porting of existing applications, where reasonable it provides functions that emulate the functionality provided in earlier Palm OS releases.
As well, a handful of functions that have historically been documented as "system use only" are not supported in Palm OS Cobalt.
Deleted APIs ^TOP^
Table 113.1 Deleted functions
Deleted API
|
Use instead
|
EvtEnqueuePenPoint()
|
Nothing. This function was documented as "system use only" and should not have been used by applications.
|
EvtGetPenBtnList()
|
There is no direct counterpart to this in Palm OS Cobalt. The functionality provided in earlier Palm OS releases by the silkscreen buttons can, in Palm OS Cobalt, be found either on the status bar or in a pinlet. Third-party developers cannot examine or manipulate the contents of the status bar in Palm OS Cobalt version 6.0.
|
EvtGetSilkscreenAreaList()
|
Nothing. This function was documented as "system use only" in Palm OS Garnet.
|
EvtGetSysEvent()
|
Nothing. This function was documented as "system use only" and should not have been used by applications.
|
EvtKeyQueueSize()
|
Nothing. In Palm OS Cobalt there isn't a separate queue for key events. (Functions that act upon the key queue—such as EvtFlushKeyQueue()—merely emulate a key queue. In reality they act upon those events that are key events in the main event queue.)
|
EvtPenQueueSize()
|
Nothing. In Palm OS Cobalt there isn't a separate queue for pen events. (Functions that act upon the pen queue—such as EvtDequeuePenPoint()—merely emulate a pen queue. In reality they act upon those events that are pen events in the main event queue.)
|
EvtProcessSoftKeyStroke()
|
HWRProcessStroke()
|
EvtSetKeyQueuePtr()
|
Nothing. This function was documented as "system use only" and should not have been used by applications.
|
EvtSetPenQueuePtr()
|
Nothing. This function was documented as "system use only" and should not have been used by applications.
|
EvtSysInit()
|
Nothing. This function was documented as "system use only" and should not have been used by applications.
|
Table 113.2 Deleted structures
Deleted API
|
Use instead
|
PenBtnInfoType
|
There is no direct counterpart to this in Palm OS Cobalt. The functionality provided in earlier Palm OS releases by the silkscreen buttons can, in Palm OS Cobalt, be found either on the status bar or in a pinlet. Third-party developers cannot examine or manipulate the contents of the status bar in Palm OS Cobalt version 6.0.
|
PenBtnListType
|
There is no direct counterpart to this in Palm OS Cobalt. The functionality provided in earlier Palm OS releases by the silkscreen buttons can, in Palm OS Cobalt, be found either on the status bar or in a pinlet. Third-party developers cannot examine or manipulate the contents of the status bar in Palm OS Cobalt version 6.0.
|
SilkscreenAreaType
|
Nothing. This structure was used only with the EvtGetSilkscreenAreaList() function, which was documented as "system use only" in Palm OS Garnet and is not supported in Palm OS Cobalt.
|
Table 113.3 Deleted types
Deleted API
|
Use instead
|
PenBtnInfoPtr
|
There is no direct counterpart to this in Palm OS Cobalt. The functionality provided in earlier Palm OS releases by the silkscreen buttons can, in Palm OS Cobalt, be found either on the status bar or in a pinlet. Third-party developers cannot examine or manipulate the contents of the status bar in Palm OS Cobalt version 6.0.
|
Table 113.4 Deleted #defines
Deleted API
|
Use instead
|
alphaGraffitiSilkscreenArea
|
Nothing. This constant was used only with the SilkscreenAreaType structure, which is not supported in Palm OS Cobalt.
|
numericGraffitiSilkscreenArea
|
Nothing. This constant was used only with the SilkscreenAreaType structure, which is not supported in Palm OS Cobalt.
|
silkscreenRectGraffiti
|
Nothing. This constant was used only with the SilkscreenAreaType structure, which is not supported in Palm OS Cobalt.
|
silkscreenRectScreen
|
Nothing. This constant was used only with the SilkscreenAreaType structure, which is not supported in Palm OS Cobalt.
|
Table 113.5 Deleted enumerated types
Deleted API
|
Use instead
|
EvtSetAutoOffCmd
|
Formerly an enum, this is now a typedef that takes one of the values defined by the EvtSetAutoOffTag enum.
|
Modified APIs ^TOP^
Table 113.6 Modified functions
Modified API
|
Description of change
|
status_t EvtDequeueKeyEvent (EventType *, Boolean)
|
The final parameter, peek , which allows you to specify whether or not the key should be left in the key queue, was declared to be an unsigned 16-bit integer in Palm OS Garnet. Note that this function was documented as System Use Only.
|
Boolean EvtSetNullEventTick (int64_t)
|
In Palm OS Garnet the tick parameter is a 32-bit unsigned integer.
|
Unchanged APIs ^TOP^
Table 113.7 Unchanged functions
EvtDequeuePenPoint()
|
EvtDequeuePenStrokeInfo()
|
EvtEnableGraffiti()
|
EvtEnqueueKey()
|
EvtFlushKeyQueue()
|
EvtFlushNextPenStroke()
|
EvtFlushPenQueue()
|
EvtKeyQueueEmpty()
|
EvtResetAutoOffTimer()
|
EvtSetAutoOffTimer()
|
EvtSysEventAvail()
|
EvtWakeup()
|
EvtWakeupWithoutNilEvent()
|
|
Table 113.8 Unchanged #defines
evtErrParamErr
|
evtErrQueueEmpty
|
evtErrQueueFull
|
|