Package com.nokia.mid.ui.locale
    Contains classes and interfaces for retrieving locale information stored
    on the device.
See:
          Description
| Interface Summary | 
| Locale | Locale represents a locale stored on the device. | 
| LocaleListener | Enables an application to learn about changes to the locale setting of
 the device. | 
 
| Class Summary | 
| LocaleManager | LocaleManager provides the access point to locale details of the device. | 
 
Package com.nokia.mid.ui.locale Description
    Contains classes and interfaces for retrieving locale information stored
    on the device.
    
    
    The principal class is LocaleManager,
    which provides the access point to locale information. Methods are
    provided to:
    
    
    - retrieve all supported locales
    
- retrieve the currently used locale
    
- register for notification of changes to locale information
    
    All information queried from LocaleManager implements the
    Locale interface. This interface has
    methods that provide detailed information about a locale.
    
    
    The following example shows how the package may be used to retrieve
    all supported locales and details about them:
    
    
    LocaleManager localeManager;
    Locale[]      availableLocales;
    Locale        currentLocale;
    String        country;
    String        language;
    int           i;
    // Retrieve all locales that the device supports
    localeManager = LocaleManager.getInstance();
    availableLocales = localeManager.getAvailableLocales();
    for(i = 0; i < availableLocales.length; i++) {
        currentLocale = (Locale)availableLocales[i];
        // Extract country and language from the locale
        country = currentLocale.getCountry();
        language = currentLocale.getLanguage();
    }
    
    System properties
    
    The following system properties are provided:
    
    
    - com.nokia.mid.ui.locale.versionIndicates the version of the API that is implemented on the device.
    Only one version of the API currently exists and therefore the value
    of this property must be "1.0".
Copyright © 2012 Nokia Corporation. All rights reserved.
Nokia is registered trademark of Nokia Corporation. Java and all Java-based marks are trademarks or registered trademarks of Oracle Corporation. Other product and company names mentioned herein may be trademarks or trade names of their respective owners. This document is confidential information of Nokia Corporation.
Disclaimer
The information in this document is provided "as is," with no warranties whatsoever, including any warranty of merchantability, fitness for any particular purpose, or any warranty otherwise arising out of any proposal, specification, or sample. Furthermore, information provided in this document is preliminary, and may be changed substantially prior to final release.
Nokia Corporation disclaims all liability, including liability for infringement of any proprietary rights, relating to this document and implementation of any information presented in this document.
Nokia Corporation retains the right to make changes to this document at any time, without notice.
License
Subject to above disclaimer, a license is hereby granted to use this documentation solely under existing Limited License Agreement and non-disclosure agreement between the companies for the agreed application development for Series 40 Nokia phones.  No other licenses e.g. to any intellectual property rights are granted herein. Any use of the screen shots of this documentation, including any icons thereof, is subject to Nokia's prior written approval.