| Package | mx.resources |
| Interface | public interface IResourceManager extends IEventDispatcher |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Trois concepts principaux sont impliqués dans la localisation : les paramètres régionaux, les ressources et les regroupements de ressources.
Un paramètre régional spécifie une langue et un pays pour lesquels votre application a été localisée. Par exemple, le paramètre régional "en_US" spécifie English (anglais) tel que parlé aux Etats-Unis (pour plus d’informations, voir la classe mx.resources.Locale).
Une ressource est une valeur nommée dépendant d’un paramètre régional. Par exemple, il se peut que votre application dispose d’une ressource dont le nom est "OPEN" et dont la valeur pour un paramètre régional English est "Open", mais dont la valeur pour un paramètre régional French est "Ouvrir".
Un regroupement de ressources est un groupe de ressources nommé dont les valeurs ont été localisées pour un paramètre régional spécifique. Un regroupement de ressources est identifié par la combinaison de ses valeurs bundleName et locale, et comporte un objet content contenant les paires nom-valeur des ressources du regroupement. Voir la documentation concernant mx.resources.IResourceBundle pour obtenir des informations sur la création standard de regroupements de ressources à partir de fichiers de propriétés.
Un objet ResourceManager unique implémentant l’interface IResourceManager gère plusieurs regroupements de ressources, éventuellement pour plusieurs paramètres régionaux, et permet d’accéder aux ressources contenues dans ces regroupements. Par exemple, vous pouvez extraire une ressource spécifique en tant que chaîne en appelant la méthode resourceManager.getString(bundleName, resourceName).
Toutes les classes qui développent la classe UIComponent, Formatter ou Validator comportent une propriété resourceManager qui fournit une référence à l’objet implémentant cette interface. Les autres classes peuvent appeler la méthode ResourceManager.getInstance() pour obtenir cet objet.
Les méthodes d’extraction de ressources telles que getString() recherchent des ressources dans les paramètres régionaux spécifiés par la propriété localeChain. Si vous changez cette propriété, votre application peut soudain utiliser, par exemple, des ressources japonaises plutôt qu’anglaises.
Lorsque votre application démarre, la classe ResourceManager reçoit automatiquement les regroupements de ressources ayant été compilés dans l’application. Si vous créez un module de code, les ressources dont ses classes ont besoin sont par défaut compilées dans le module. Lorsque le module est chargé dans une application, les regroupements dont l’application ne dispose pas déjà sont ajoutés à la classe ResourceManager.
Vous pouvez compiler des « modules de ressources » ne contenant que des ressources et les charger avec la méthode loadResourceModule() de la classe IResourceManager. Avec les modules de ressources, vous pouvez prendre en charge plusieurs paramètres régionaux en chargeant les ressources requises lors de l’exécution au lieu de les compiler dans votre application.
Bien que la classe ResourceManager reçoive normalement les regroupements de ressources ayant été compilés dans votre application ou chargé à partir de modules, vous pouvez aussi créer par programmation des regroupements de ressources et les ajouter vous-même à la classe ResourceManager avec la méthode addResourceBundle().
Eléments de l’API associés
| Propriété | Défini par | ||
|---|---|---|---|
| localeChain : Array
Tableau de chaînes de paramètres régionaux, tel que [ "en_US" ], qui spécifie un ou plusieurs paramètres régionaux dans lequel rechercher des ressources. | IResourceManager | ||
Masquer les méthodes publiques héritées
Afficher les méthodes publiques héritées| Méthode | Défini par | ||
|---|---|---|---|
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | IEventDispatcher | |
Ajoute le regroupement ResourceBundle spécifié à la classe ResourceManager de sorte que ses ressources soient accessibles par des méthodes ResourceManager telles que getString(). | IResourceManager | ||
|
Distribue un événement dans le flux d’événements. | IEventDispatcher | |
Recherche la ressource spécifiée dans les paramètres régionaux dans la propriété localeChain et renvoie le premier regroupement de ressource dans lequel elle est trouvée. | IResourceManager | ||
Obtient la valeur d’une ressource spécifiée en tant que valeur booléenne. | IResourceManager | ||
Renvoie un tableau de chaînes spécifiant les noms de regroupements pour tous les objets ResourceBundle qui existent dans la classe ResourceManager et qui appartiennent au paramètre régional spécifié. | IResourceManager | ||
Obtient la valeur d’une ressource spécifiée en tant qu’objet Class. | IResourceManager | ||
Obtient la valeur d’une ressource spécifiée en tant que valeur entière. | IResourceManager | ||
Renvoie un tableau de chaînes spécifiant tous les paramètres régionaux pour lesquels les objets ResourceBundle existent dans la classe ResourceManager. | IResourceManager | ||
Obtient la valeur d’une ressource spécifiée en tant que nombre. | IResourceManager | ||
Obtient la valeur d’une ressource spécifiée en tant qu’objet. | IResourceManager | ||
Renvoie un tableau de chaînes spécifiant tous les paramètres régionaux pour lesquels les objets ResourceBundle existent dans la classe ResourceManager, triés selon les préférences de l’utilisateur tel que signalé par Capabilities.language ou Capabilities.languages. | IResourceManager | ||
Renvoie un regroupement ResourceBundle avec la valeur locale et bundleName spécifiée ayant précédemment été ajoutée à la classe ResourceManager avec addResourceBundle(). | IResourceManager | ||
getString(bundleName:String, resourceName:String, parameters:Array = null, locale:String = null):String
Obtient la valeur d’une ressource spécifiée en tant que chaîne, après remplacement des valeurs spécifiées par des espaces réservés. | IResourceManager | ||
Obtient la valeur d’une ressource spécifiée en tant que tableau de chaînes. | IResourceManager | ||
Obtient la valeur d’une ressource spécifiée en tant qu’entier non signé. | IResourceManager | ||
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | IEventDispatcher | |
Initialise la propriété localeChain de la classe ResourceManager à l’aide d’un algorithme qui compare la liste des paramètres régionaux préférés par l’utilisateur du système d’exploitation avec la liste des paramètres régionaux disponibles dans le fichier SWF. | IResourceManager | ||
installCompiledResourceBundles(applicationDomain:ApplicationDomain, locales:Array, bundleNames:Array, useWeakReference:Boolean = false):Array
Crée des instances de toutes les sous-classes ResourceBundle qui ont été compilées dans le fichier SWF et les ajoute à la classe ResourceManager. | IResourceManager | ||
loadResourceModule(url:String, update:Boolean = true, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
Commence à charger un module de ressource contenant des regroupements de ressources. | IResourceManager | ||
|
Supprime un écouteur de l’objet EventDispatcher. | IEventDispatcher | |
Supprime le regroupement ResourceBundle spécifié de la classe ResourceManager de sorte que ses ressources ne soient plus accessibles par des méthodes ResourceManager telles que getString(). | IResourceManager | ||
Supprime de la classe ResourceManager tous les regroupements ResourceBundle pour le paramètre régional spécifié de sorte que leurs ressources ne soient plus accessibles par des méthodes ResourceManager telles que getString(). | IResourceManager | ||
Commence le déchargement d’un module de ressource chargé. | IResourceManager | ||
Distribue un événement change à partir de la classe ResourceManager. | IResourceManager | ||
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | IEventDispatcher | |
localeChain | propriété |
localeChain:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Tableau de chaînes de paramètres régionaux, tel que [ "en_US" ], qui spécifie un ou plusieurs paramètres régionaux dans lequel rechercher des ressources.
Lorsque vous appelez les méthodes ResourceManager getObject(), getString(), getStringArray(), getNumber(), getInt(), getUint(), getBoolean() ou getClass() pour obtenir la valeur d’une ressource, vous spécifiez un nom de regroupement et un nom de ressource, mais pas un paramètre régional. La classe ResourceManager commence par le premier paramètre régional dans la propriété localeChain et recherche un regroupement ResourceBundle avec le nom de regroupement spécifié pour ce paramètre régional. S’il existe un tel regroupement ResourceBundle et que la ressource spécifiée y existe, la valeur de cette ressource est renvoyée. Dans le cas contraire, la classe ResourceManager passe aux autres paramètres régionaux dans la propriété localeChain.
Avec ce schéma, il est possible de disposer de paramètres régionaux ne contenant pas nécessairement un ensemble complet de ressources localisées. Par exemple, si vous localisez votre application pour la l’anglais indien plutôt qu’américain, vous ne devez fournir des ressources que pour le paramètre régional en_IN dans lequel l’orthographe ou l’utilisation indienne diffère de l’orthographe et de l’utilisation américains, puis définir la propriété localeChain sur [ "en_IN", "en_US" ].
De nombreuses classes de structures considèrent qu’elles peuvent toujours obtenir, à partir d’un paramètre régional, les ressources auxquelles elles s’attendent, et génèrent des erreurs si cela leur est impossible. Aussi, vous devez vous assurer que le paramètre régional localeChain contient toujours un ensemble complet de ressources. A moins que vous n’ayez entièrement localisé toutes les ressources de la structure ainsi que celles de votre propre application, vous pouvez conserver le paramètre régional "en_US" à la fin de votre paramètre localeChain pour garantir ceci.
Si cette propriété est définie, la classe ResourceManager distribue un événement "change".
Implémentation
public function get localeChain():Array public function set localeChain(value:Array):voidaddResourceBundle | () | méthode |
public function addResourceBundle(resourceBundle:IResourceBundle, useWeakReference:Boolean = false):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Ajoute le regroupement ResourceBundle spécifié à la classe ResourceManager de sorte que ses ressources soient accessibles par des méthodes ResourceManager telles que getString().
Paramètres
resourceBundle:IResourceBundle — Regroupement de ressources à ajouter.
| |
useWeakReference:Boolean (default = false)useWeakReference a la valeur true, ResourceManager fournit une référence faible au groupe de ressources. Si l’appelant choisit d’utiliser une référence faible, l’appelant est alors chargé de conserver une référence forte du groupe de ressources de façon qu’il ne soit pas nettoyé prématurément. Si useWeakReference a la valeur false, ResourceManager conserve une référence forte du groupe de ressources. Il n’est pas nettoyé.
Lorsqu’une sous-application ou un module Flex ajoute automatiquement ses groupes de ressources compilés à ResourceManager, cela appelle |
findResourceBundleWithResource | () | méthode |
public function findResourceBundleWithResource(bundleName:String, resourceName:String):IResourceBundle| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Recherche la ressource spécifiée dans les paramètres régionaux dans la propriété localeChain et renvoie le premier regroupement de ressource dans lequel elle est trouvée. Si la ressource n’est pas trouvée, cette méthode renvoie null.
Paramètres
bundleName:String — Nom de regroupement tel que "MyResources".
| |
resourceName:String — Nom d’une ressource dans un regroupement de ressources.
|
IResourceBundle — Premier regroupement ResourceBundle dans la propriété localeChain contenant la ressource spécifiée, ou null.
|
getBoolean | () | méthode |
public function getBoolean(bundleName:String, resourceName:String, locale:String = null):Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient la valeur d’une ressource spécifiée en tant que valeur booléenne.
Cette méthode appelle d’abord getString() et convertit le résultat en minuscules. Elle renvoie ensuite true si le résultat est "true" et false dans le cas contraire.
Si la ressource spécifiée n’est pas trouvée, cette méthode renvoie false.
Paramètres
bundleName:String — Nom d’un regroupement de ressources.
| |
resourceName:String — Nom d’une ressource dans un regroupement de ressources.
| |
locale:String (default = null)null pour rechercher tous les paramètres régionaux dans la propriété localeChain. Ce paramètre est facultatif et prend par défaut la valeur null ; il est normalement rarement nécessaire de le spécifier.
|
Boolean — Valeur de la ressource, en tant que valeur booléenne, ou false si elle n’est pas trouvée.
|
getBundleNamesForLocale | () | méthode |
public function getBundleNamesForLocale(locale:String):Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie un tableau de chaînes spécifiant les noms de regroupements pour tous les objets ResourceBundle qui existent dans la classe ResourceManager et qui appartiennent au paramètre régional spécifié.
L’ordre des noms de regroupements dans ce tableau n’est pas spécifié.
Paramètres
locale:String — Chaîne de paramètres régionaux, telle que "en_US".
|
Array — Tableau de noms de regroupements.
|
Eléments de l’API associés
getClass | () | méthode |
public function getClass(bundleName:String, resourceName:String, locale:String = null):Class| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient la valeur d’une ressource spécifiée en tant qu’objet Class.
Cette méthode appelle getObject() et la contraint vers le type Class à l’aide de l’opérateur as. Le résultat est null si la valeur de la ressource n’est pas une référence de classe. Cela est utile si vous avez écrit une ligne comme dans
IMAGE=Embed("image.jpg")
BUTTON_SKIN=ClassReference("skins.ButtonSkin_en_US")
un fichier de propriétés et voulez obtenir l’objet Class que la directive Embed() ou ClassReference() a produit.
Si la ressource spécifiée n’est pas trouvée, cette méthode renvoie null.
Paramètres
bundleName:String — Nom d’un regroupement de ressources.
| |
resourceName:String — Nom d’une ressource dans un regroupement de ressources.
| |
locale:String (default = null)null pour rechercher tous les paramètres régionaux dans la propriété localeChain. Ce paramètre est facultatif et prend par défaut la valeur null ; il est normalement rarement nécessaire de le spécifier.
|
Class — Valeur de la ressource, en tant que Class, ou null si elle n’est pas trouvée.
|
getInt | () | méthode |
public function getInt(bundleName:String, resourceName:String, locale:String = null):int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient la valeur d’une ressource spécifiée en tant que valeur entière.
Cette méthode appelle getObject() et projette le résultat vers une valeur entière. Cela est utile si vous avez écrit une ligne comme :
MINIMUM=5
dans un fichier de propriétés et voulez obtenir la valeur 5 plutôt que "5".
Si la ressource spécifiée n’est pas trouvée, cette méthode renvoie 0.
Paramètres
bundleName:String — Nom d’un regroupement de ressources.
| |
resourceName:String — Nom d’une ressource dans un regroupement de ressources.
| |
locale:String (default = null)null pour rechercher tous les paramètres régionaux dans la propriété localeChain. Ce paramètre est facultatif et prend par défaut la valeur null ; il est normalement rarement nécessaire de le spécifier.
|
int — Valeur de la ressource, en tant que valeur entière, ou 0 si elle n’est pas trouvée.
|
getLocales | () | méthode |
public function getLocales():Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie un tableau de chaînes spécifiant tous les paramètres régionaux pour lesquels les objets ResourceBundle existent dans la classe ResourceManager.
L’ordre des paramètres régionaux dans ce tableau n’est pas spécifié.
Valeur renvoyéeArray — Tableau de chaînes de paramètres régionaux.
|
getNumber | () | méthode |
public function getNumber(bundleName:String, resourceName:String, locale:String = null):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient la valeur d’une ressource spécifiée en tant que nombre.
Cette méthode appelle getObject() et projette le résultat vers un nombre. Cela est utile si vous avez écrit une ligne comme :
LONGITUDE=170.3
dans un fichier de propriétés et voulez obtenir la valeur 170.3 plutôt que "170.3".
Si la ressource spécifiée n’est pas trouvée, cette méthode renvoie NaN.
Paramètres
bundleName:String — Nom d’un regroupement de ressources.
| |
resourceName:String — Nom d’une ressource dans un regroupement de ressources.
| |
locale:String (default = null)null pour rechercher tous les paramètres régionaux dans la propriété localeChain. Ce paramètre est facultatif et prend par défaut la valeur null ; il est normalement rarement nécessaire de le spécifier.
|
Number — Valeur de la ressource, en tant que nombre, ou NaN si elle n’est pas trouvée.
|
getObject | () | méthode |
public function getObject(bundleName:String, resourceName:String, locale:String = null):*| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient la valeur d’une ressource spécifiée en tant qu’objet.
La valeur est renvoyée exactement telle qu’elle est stockée dans l’objet content du regroupement ResourceBundle, sans conversion. Si la ressource a été compilée à partir d’un fichier de propriétés, la valeur de la ressource dans l’objet content est toujours une chaîne sauf si vous avez utilisé la directive Embed() ou ClassReference(), auquel cas il s’agit d’un objet Class. Utilisez les méthodes getString(), getStringArray(), getNumber(), getInt() getUint(), getBoolean() et getClass() pour convertir la valeur en des types plus spécifiques.
Si la ressource spécifiée n’est pas trouvée, cette méthode renvoie undefined.
Paramètres
bundleName:String — Nom d’un regroupement de ressources.
| |
resourceName:String — Nom d’une ressource dans un regroupement de ressources.
| |
locale:String (default = null)null pour rechercher tous les paramètres régionaux dans la propriété localeChain. Ce paramètre est facultatif et prend par défaut la valeur null ; il est normalement rarement nécessaire de le spécifier.
|
* — Valeur de la ressource, exactement telle qu’elle est stockée dans l’objet content, ou undefined si la ressource n’est pas trouvée.
|
getPreferredLocaleChain | () | méthode |
public function getPreferredLocaleChain():Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie un tableau de chaînes spécifiant tous les paramètres régionaux pour lesquels les objets ResourceBundle existent dans la classe ResourceManager, triés selon les préférences de l’utilisateur tel que signalé par Capabilities.language ou Capabilities.languages.
Array — Tableau de chaînes de paramètres régionaux.
|
getResourceBundle | () | méthode |
public function getResourceBundle(locale:String, bundleName:String):IResourceBundle| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie un regroupement ResourceBundle avec la valeur locale et bundleName spécifiée ayant précédemment été ajoutée à la classe ResourceManager avec addResourceBundle(). Si un tel regroupement ResourceBundle n’existe pas, cette méthode renvoie null.
Paramètres
locale:String — Chaîne de paramètres régionaux, telle que "en_US".
| |
bundleName:String — Nom de regroupement tel que "MyResources".
|
IResourceBundle — Regroupement ResourceBundle avec la valeur locale et bundleName spécifiée s’il en existe une ; dans le cas contraire, null.
|
Eléments de l’API associés
getString | () | méthode |
public function getString(bundleName:String, resourceName:String, parameters:Array = null, locale:String = null):String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient la valeur d’une ressource spécifiée en tant que chaîne, après remplacement des valeurs spécifiées par des espaces réservés.
Cette méthode appelle getObject(), puis projette le résultat vers une chaîne.
Si un tableau de valeurs parameters est transmis à cette méthode, les paramètres qu’il contient sont convertis en chaînes puis remplacés, dans l’ordre, par les espaces réservés "{0}", "{1}", et ainsi de suite, dans la chaîne avant qu’elle ne soit renvoyée.
Si la ressource spécifiée n’est pas trouvée, cette méthode renvoie null.
Paramètres
bundleName:String — Nom d’un regroupement de ressources.
| |
resourceName:String — Nom d’une ressource dans un regroupement de ressources.
| |
parameters:Array (default = null)toString() avant d’être remplacé.
| |
locale:String (default = null)null pour rechercher tous les paramètres régionaux dans la propriété localeChain. Ce paramètre est facultatif et prend par défaut la valeur null ; il est normalement rarement nécessaire de le spécifier.
|
String — Valeur de la ressource, en tant que chaîne, ou null si elle n’est pas trouvée.
|
getStringArray | () | méthode |
public function getStringArray(bundleName:String, resourceName:String, locale:String = null):Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient la valeur d’une ressource spécifiée en tant que tableau de chaînes.
Cette méthode considère que la valeur de la ressource est une chaîne contenant une liste d’éléments séparés par une virgule. Elle appelle la méthode getString(), divise la chaîne en éléments au niveau des virgules et insère un espace blanc avant et après chaque élément. Cela est utile si vous avez écrit une ligne comme :
COUNTRIES=India, China, Japan
dans un fichier de propriétés et voulez obtenir la valeur [ "India", "China", "Japan" ] plutôt que la valeur "India, China, Japan".
Si la ressource spécifiée n’est pas trouvée, cette méthode renvoie null.
Paramètres
bundleName:String — Nom d’un regroupement de ressources.
| |
resourceName:String — Nom d’une ressource dans un regroupement de ressources.
| |
locale:String (default = null)null pour rechercher tous les paramètres régionaux dans la propriété localeChain. Ce paramètre est facultatif et prend par défaut la valeur null ; il est normalement rarement nécessaire de le spécifier.
|
Array — Valeur de la ressource, en tant que tableau de chaînes, ou null si elle n’est pas trouvée.
|
getUint | () | méthode |
public function getUint(bundleName:String, resourceName:String, locale:String = null):uint| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient la valeur d’une ressource spécifiée en tant qu’entier non signé.
Cette méthode appelle la méthode getObject() et projette le résultat vers un entier non signé. Cela est utile si vous avez écrit une ligne comme :
MINIMUM=5
dans un fichier de propriétés et voulez obtenir la valeur 5 plutôt que "5".
Si la ressource spécifiée n’est pas trouvée, cette méthode renvoie 0.
Paramètres
bundleName:String — Nom d’un regroupement de ressources.
| |
resourceName:String — Nom d’une ressource dans un regroupement de ressources.
| |
locale:String (default = null)null pour rechercher tous les paramètres régionaux dans la propriété localeChain. Ce paramètre est facultatif et prend par défaut la valeur null ; il est normalement rarement nécessaire de le spécifier.
|
uint — Valeur de la ressource, en tant qu’entier non signé, ou 0 si elle n’est pas trouvée.
|
initializeLocaleChain | () | méthode |
public function initializeLocaleChain(compiledLocales:Array):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Initialise la propriété localeChain de la classe ResourceManager à l’aide d’un algorithme qui compare la liste des paramètres régionaux préférés par l’utilisateur du système d’exploitation avec la liste des paramètres régionaux disponibles dans le fichier SWF.
Par exemple, si l’utilisateur a indiqué dans le système d’exploitation qu’il préfère le français, et que le fichier SWF a été compilé pour les langues en_US, fr_FR et de_DE, la propriété localeChain est définie de façon à ce que la première langue qu’elle contient soit le français (fr_FR).
Cette méthode n’est utilisée que par les classes qui implémentent l’interface IFlexModuleFactory.
Paramètres
compiledLocales:Array — Tableau de chaînes spécifiant les paramètres régionaux pour lesquelles le fichier SWF a été compilé.
|
Eléments de l’API associés
installCompiledResourceBundles | () | méthode |
public function installCompiledResourceBundles(applicationDomain:ApplicationDomain, locales:Array, bundleNames:Array, useWeakReference:Boolean = false):Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Crée des instances de toutes les sous-classes ResourceBundle qui ont été compilées dans le fichier SWF et les ajoute à la classe ResourceManager.
Par exemple, si le paramètre locales a la valeur [ "en_US", "ja_JP" ] et que le paramètre bundleNames a la valeur [ "core", "controls" ], quatre ensembles de ressources sont installés.
Cette méthode n’est utilisée que par les classes qui implémentent l’interface IFlexModuleFactory.
Paramètres
applicationDomain:ApplicationDomain — Domaine d’application qui est utilisé pour rechercher les classes d’ensembles de ressources par nom.
| |
locales:Array — Tableau de chaînes spécifiant les paramètres régionaux pour lesquels le fichier SWF a été compilé.
| |
bundleNames:Array — Tableau de chaînes qui spécifient les noms des ensembles de ressources qui ont été compilés dans le fichier SWF.
| |
useWeakReference:Boolean (default = false) |
Array — Tableau des instances ResourceBundle qui ont été créées et ajoutées à la classe ResourceManager.
|
Eléments de l’API associés
loadResourceModule | () | méthode |
public function loadResourceModule(url:String, update:Boolean = true, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Commence à charger un module de ressource contenant des regroupements de ressources.
Chaque appel à cette méthode renvoie un nouvel objet de distribution d’événement que vous pouvez utiliser pour connaître la progression du chargement et savoir s’il s’est terminé correctement ou a résulté en une erreur. Cet objet distribue des événements ResourceEvent.PROGRESS, ResourceEvent.COMPLETE et ResourceEvent.ERROR.
Lorsque le module a été chargé, les regroupements de ressources sont ajoutés à la classe ResourceManager, mais la propriété localeChain reste inchangée. Si le paramètre update est true, la méthode update() est appelée.
Paramètres
url:String — URL à partir de laquelle charger le module de ressource.
| |
update:Boolean (default = true)update() lorsque le module termine le chargement.
| |
applicationDomain:ApplicationDomain (default = null)load() de la classe IModuleInfo qui charge le module de ressource. Ce paramètre est facultatif et prend par défaut la valeur null.
| |
securityDomain:SecurityDomain (default = null)load() de la classe IModuleInfo qui charge le module de ressource. Ce paramètre est facultatif et prend par défaut la valeur null.
|
IEventDispatcher — Objet associé à cette opération load spécifique qui distribue des événements ResourceEvent.PROGRESS, ResourceEvent.COMPLETE et ResourceEvent.ERROR.
|
Eléments de l’API associés
removeResourceBundle | () | méthode |
public function removeResourceBundle(locale:String, bundleName:String):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime le regroupement ResourceBundle spécifié de la classe ResourceManager de sorte que ses ressources ne soient plus accessibles par des méthodes ResourceManager telles que getString().
Paramètres
locale:String — Chaîne de paramètres régionaux, telle que "en_US".
| |
bundleName:String — Nom de regroupement tel que "MyResources".
|
Eléments de l’API associés
removeResourceBundlesForLocale | () | méthode |
public function removeResourceBundlesForLocale(locale:String):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime de la classe ResourceManager touts les regroupements ResourceBundle pour le paramètre régional spécifié de sorte que leurs ressources ne soient plus accessibles par des méthodes ResourceManager telles que getString().
Paramètres
locale:String — Chaîne de paramètres régionaux, telle que "en_US".
|
Eléments de l’API associés
unloadResourceModule | () | méthode |
public function unloadResourceModule(url:String, update:Boolean = true):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Commence le déchargement d’un module de ressource chargé.
Lorsque le module est déchargé, ses regroupements de ressources sont supprimés du gestionnaire ResourceManager, mais la localeChain demeure inchangé. Si le paramètre update est true, la méthode update() est appelée.
Paramètres
url:String — URL utilisée pour charger le module de ressource.
| |
update:Boolean (default = true)update() lorsque le module termine le déchargement.
|
update | () | méthode |
public function update():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribue un événement change à partir de la classe ResourceManager.
Cela amène les expressions de liaison à réévaluer si elles impliquent les méthodes ResourceManager getObject(), getString(), getStringArray(), getNumber(), getInt(), getUint(), getBoolean() ou getClass().
Cela provoque également l’exécution de la méthode resourcesChanged() d’une classe UIComponent, Formatter ou Validator. De nombreux composants implémentent cette méthode pour mettre à jour leur état en fonction des dernières ressources.
Tue Jun 12 2018, 09:30 AM Z