IResourceManager  - AS3 Flex

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".

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

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

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

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

Eléments de l’API associés

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

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

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é.

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

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

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.

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

Eléments de l’API associés

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

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

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

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

Eléments de l’API associés

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

Eléments de l’API associés

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

Eléments de l’API associés

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

Eléments de l’API associés

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

Eléments de l’API associés

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

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.