Documentation  |   Table of Contents   |  < Previous   |  Next >  

75    OverlayMgr.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

The functionality provided by the Overlay Manager in earlier Palm OS releases is, in Palm OS Cobalt, supplied by the Data Manager and by the Locale Manager. Those APIs that deal directly with locales can be found in the Locale Manager, while those APIs that work with overlays are declared as part of the Data Manager API set.

Deleted APIs ^TOP^

Table 75.1  Deleted functions 

Deleted API

Use instead

OmGetCurrentLocale()

DmGetOverlayLocale()

OmGetIndexedLocale()

Use LmGetNumLocales() to get the number of known locales. Use LmGetLocaleSetting() to obtain information about a locale given its index.

OmGetNextSystemLocale()

Iterate through the known locales by index (from 0 to one less than the value returned by LmGetNumLocales()) and use LmGetLocaleSetting() to obtain information about a locale given its index.

OmGetRoutineAddress()

Nothing. This function is not needed in Palm OS Cobalt.

OmGetSystemLocale()

LmGetSystemLocale()

OmLocaleToOverlayDBName()

DmGetOverlayDatabaseName()

OmOverlayDBNameToLocale()

DmGetOverlayDatabaseLocale()

OmSetSystemLocale()

LmSetSystemLocale()

Table 75.2  Deleted macros

Deleted API

Use instead

OMDISPATCH_TRAP()

Nothing. The 68K trap dispatch mechanism isn't used in Palm OS Cobalt.

Table 75.3  Deleted structures

Deleted API

Use instead

OmSearchStateType

In previous versions of Palm OS this structure is used by OmGetNextSystemLocale(), a function that is not supported in Palm OS Cobalt. Instead, iterate through the known locales by index (from 0 to one less than the value returned by LmGetNumLocales()) and use LmGetLocaleSetting() to obtain information about a locale given its index. You can then determine whether or not the locale meets your desired criteria.

Table 75.4  Deleted types

Deleted API

Use instead

OmLocaleType

LmLocaleType

OmSelector

Nothing. In previous versions of Palm OS this type is used by OmGetRoutineAddress(), a function that is neither needed nor supported in Palm OS Cobalt.

Table 75.5  Deleted #defines 

Deleted API

Use instead

omErr...

lmErr... or dmErr..., as appropriate.

omFtrCreator

Nothing. In Palm OS Cobalt there are no overlay- or locale-related features that vary from one version to the next.

omFtrDefaultLocale

LmGetROMLocale()

omFtrShowErrorsFlag

Nothing. The display of overlay- and locale-related errors is not controllable.

omGetCurrentLocale, omGetIndexedLocale, omGetNextSystemLocale, omGetRoutineAddress, omGetSystemLocale, omInit, omLocaleToOverlayDBName, omOpenOverlayDatabase, omOverlayDBNameToLocale, omSetSystemLocale, omMaxSelector

Nothing. These constants were used with the 68K trap dispatch mechanism and with OmGetRoutineAddress(), neither of which are used in Palm OS Cobalt.

omOverlayRscID

omOverlayRscType

sysFileTOverlay