Documentation  |   Table of Contents   |  < Previous   |  Next >  

66    LocaleMgr.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

Minor changes only. The bulk of the changes arise from the fact that the 68K trap dispatch mechanism isn't used in Palm OS Cobalt.

Deleted APIs ^TOP^

Table 66.1  Deleted macros

Deleted API

Use instead

LMDISPATCH_TRAP()

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

Table 66.2  Deleted types

Deleted API

Use instead

LmRoutineSelector

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

Table 66.3  Deleted #defines 

Deleted API

Use instead

DIRECT_LOCALE_CALLS

Nothing; this constant was only used to control how Locale Manager functions were called and is not needed in Palm OS Cobalt.

lmChoiceLanguageName

Pass lmChoiceCountryName to LmGetLocaleSetting() to get the country name, then supply that name to LmISONameToLanguage().

lmGetLocaleSetting, lmGetNumLocales, lmInit, lmLocaleToIndex, lmMaxRoutineSelector

Nothing. These constants were used with the 68K trap dispatch mechanism, which isn't used in Palm OS Cobalt.

SUPPORT_LANGUAGE_NAME

Nothing; this constant determined whether or not the lmChoiceLanguageName locale setting was available. It is not in Palm OS Cobalt; see the description of the lmChoiceLanguageName #define, above.

Modified APIs ^TOP^

Table 66.4  Modified #defines

Modified API

Description of change

#define kMaxCountryNameLen 31

In Palm OS versions prior to Palm OS Cobalt, country names are limited to 19 characters (plus the null terminator).

#define kMaxCurrencyNameLen 31

In Palm OS versions prior to Palm OS Cobalt, currency names are limited to 19 characters (plus the null terminator).

#define kMaxCurrencySymbolLen 10

In Palm OS versions prior to Palm OS Cobalt, symbol names are limited to 19 characters (plus the null terminator).

#define lmAnyCountry ((LmCountryType)'\?\?')

In Palm OS versions prior to Palm OS Cobalt, this constant has a value of 65535.

#define lmAnyLanguage ((LmLanguageType)'\?\?')

In Palm OS versions prior to Palm OS Cobalt, this constant has a value of 65535.

Unchanged APIs ^TOP^

Table 66.5  Unchanged functions

LmGetLocaleSetting()

LmGetNumLocales()

LmLocaleToIndex()

Table 66.6  Unchanged structures

_LmLocaleType

LmLocaleType

Table 66.7  Unchanged types

CountryType

LanguageType

LmLocaleSettingChoice

Table 66.8  Unchanged #defines

lmChoiceCountryName

lmChoiceCurrencyDecimalPlaces

lmChoiceCurrencyName

lmChoiceCurrencySymbol

lmChoiceDateFormat

lmChoiceInboundDefaultVObjectEncoding

lmChoiceLocale

lmChoiceLongDateFormat

lmChoiceMeasurementSystem

lmChoiceNumberFormat

lmChoiceOutboundVObjectEncoding

lmChoicePrimaryEmailEncoding

lmChoicePrimarySMSEncoding

lmChoiceSecondaryEmailEncoding

lmChoiceSecondarySMSEncoding

lmChoiceSupportsLunarCalendar

lmChoiceTimeFormat

lmChoiceTimeZone

lmChoiceUniqueCurrencySymbol

lmChoiceWeekStartDay

lmErr...