Documentation  |   Table of Contents   |  < Previous   |  Next >  

113    SysEvtMgr.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

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