ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Internationalizing applications
The next step is to load and display strings and user interface resources that are specific to the locale. This step can
include tasks such as:
Using the autolayout features to resize the UI to accommodate the string lengths
Choosing the right fonts and supporting font fallbacks
Using the FTE text engine to support other writing systems
Ensuring that input method editors are correctly handled
Checking for errors and fallbacks
The flash.globalization service classes all follow a similar pattern for identifying errors. They also share a pattern for
falling back from an unavailable requested locale to one that the user’s operating system supports.
The following example shows how to check for errors and fallbacks when instantiating service classes. Each service
class has a lastOperationStatus property that indicates whether the most recent method call triggered their errors or
warnings.
var nf:NumberFormatter = new NumberFormatter("de-DE");
if(nf.lastOperationStatus != LastOperationStatus.NO_ERROR)
{
if(nf.lastOperationStatus == LastOperationStatus.USING_FALLBACK_WARNING)
{
// perform fallback logic here, if needed
trace("Warning - Fallback locale ID: " + nf.actualLocaleIDName);
}
else
{
// perform error handling logic here, if needed
trace("Error: " + nf.lastOperationStatus);
}
}
This example simply traces a message if a fallback locale ID is used, or if there is an error. Your application can perform
additional error handling logic, if needed. For example, you could display a message to the user or force the application
to use a specific, supported locale.
Determining the locale
Flash Player 10.1 and later, Adobe AIR 2.0 and later
A locale identifies a specific combination of language and cultural conventions for a country or region.
A locale identifier can be safely managed as a string. But you can use the LocaleID class to obtain additional
information related to a locale.
You create a LocaleID object as follows:
var locale:LocaleID = new LocaleID("es-MX");
After the LocaleID object is created, you can retrieve data about the locale ID. Use the getKeysAndValues(),
getLanguage(), getRegion(), getScript(), getVariant(), and isRightToLeft() methods, and the name
property.
Last updated 6/6/2012
941