Paket | mx.resources |
Schnittstelle | public interface IResourceManager extends IEventDispatcher |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Lokalisierung umfasst drei wesentliche Konzepte: Gebietsschemas, Ressourcen und ResourceBundles.
Ein Gebietsschema legt eine Sprache und ein Land fest, für welche Ihre Anwendung lokalisiert wird. Beispiel: Gebietsschema "en_US"
legt das in den USA gesprochene Englisch fest. (Weitere Informationen finden Sie unter mx.resources.Locale-Klasse.)
Eine Ressource ist ein vom Gebietsschema abhängiger benannter Wert. Beispiel: Ihre Anwendung besitzt eine Ressource, deren Name "OPEN"
lautet und deren Wert für ein englisches Gebietsschema "Open"
ist. Der Wert für ein französisches Gebietsschema ist jedoch "Ouvrir"
.
Ein ResourceBundle ist eine benannte Gruppe von Ressourcen, deren Werte für ein bestimmtes Gebietsschema lokalisiert wurden. Ein ResourceBundle wird durch die Kombination seines bundleName
und seines locale
identifiziert und besitzt ein content
-Objekt, welches die Name-/Wertepaare der Ressourcen des Bundles enthält. In der Dokumentation zu mx.resources.IResourceBundle finden Sie Informationen darüber, wie ResourceBundles normalerweise aus Eigenschaftendateien erstellt werden.
Ein einzelnes ResourceManager-Objekt, welches die IResourceManager-Schnittstelle implementiert, verwaltet verschiedene ResourceBundles für mehrere Gebietsschemas und bietet Zugriff auf die Ressourcen, welche sie enthalten. Beispiel: Sie können einen bestimmten Ressourcenstring abrufen, indem Sie resourceManager.getString(bundleName, resourceName)
aufrufen.
Alle Klassen, die UIComponent oder den Formatierer oder den Validator erweitern, besitzen eine resourceManager
-Eigenschaft, welche einen Verweis auf das Objekt bereitstellt, welches die Schnittstelle implementiert. Andere Klassen können ResourceManager.getInstance()
aufrufen, um dieses Objekt zu beziehen.
Methoden, die Ressourcen abrufen, wie z. B. getString()
, durchsuchen Gebietsschemas, welche durch dielocaleChain
-Eigenschaft festgelegt sind, nach Ressourcen. Durch Änderung dieser Eigenschaft können Sie Ihre Anwendung dazu bringen, z. B. japanische statt englische Ressourcen zu verwenden.
Wenn Ihre Anwendung startet, wird ResourceManager automatisch mit allen in die Anwendung kompilierten Ressourcen gefüllt. Wenn Sie ein Codemodul erzeugen, werden die Ressourcen, welche seine Klassen benötigen, standardmäßig in das Modul kompiliert. Wenn das Modul in eine Anwendung geladen wird, werden alle Bundles, welche die Anwendung nicht schon besitzt, dem ResourceManager hinzugefügt.
Sie können „Ressourcenmodule“ kompilieren, die nur Ressourcen enthalten. Diese können Sie mit der loadResourceModule()
-Methode des IResourceManager laden. Mit Ressourcenmodulen können Sie mehrere Gebietsschemas unterstützen, indem Sie die benötigten Ressourcen während der Laufzeit laden, statt sie in die Anwendung zu kompilieren.
Zwar wird ResourceManager normalerweise mit ResourceBundles gefüllt, welche entweder in Ihre Anwendung kompiliert oder aus einem Modul geladen wurden, Sie können ResourceBundles aber auch programmgesteuert erstellen und sie mit der addResourceBundle()
-Methode selbst dem ResourceManager hinzufügen.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
localeChain : Array
Ein Array von Gebietsschemastrings, z. B. [ „en_US“ ], welches ein oder mehrere Gebietsschemas festlegt, die nach Ressourcen durchsucht werden können. | IResourceManager |
Methode | Definiert von | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | IEventDispatcher | ||
Fügt ResourceManager ein bestimmtes ResourceBundle hinzu, sodass auf seine Ressourcen durch ResourceManager-Methoden wie z. B. getString() zugegriffen werden kann. | IResourceManager | ||
Sendet ein Ereignis in den Ereignisablauf. | IEventDispatcher | ||
Sucht das Gebietsschema in localeChain für die festgelegte Ressource und gibt das erste ResourceBundle zurück, das gefunden wurde. | IResourceManager | ||
Ruft den Wert einer festgelegten Ressource als booleschen Wert ab. | IResourceManager | ||
Gibt ein Array von Strings zurück, welches die Bundle-Namen für alle ResourceBundle-Objekte festlegt, welche im ResourceManager vorliegen, und welche zum festgelegten Gebietsschema gehören. | IResourceManager | ||
Ruft den Wert einer festgelegten Ressource als Klasse ab. | IResourceManager | ||
Ruft den Wert einer festgelegten Ressource als int-Wert ab. | IResourceManager | ||
Gibt ein Array von Strings zurück, welches alle Gebietsschemas festlegt, für welche ResourceBundle-Objekte im ResourceManager existieren. | IResourceManager | ||
Ruft den Wert einer festgelegten Ressource als Zahl ab. | IResourceManager | ||
Ruft den Wert einer festgelegten Ressource als Objekt ab. | IResourceManager | ||
Gibt ein Array von Strings zurück, welches alle Gebietsschemas, für welche ResourceBundle-Objekte im ResourceManager existieren, festlegt. Geordnet nach den von Capabilities.language oder Capabilities.languages gemeldeten Benutzereinstellungen. | IResourceManager | ||
Gibt ein ResourceBundle mit dem festgelegten Gebietsschema und bundleName zurück, welches zuvor zum ResourceManager mit addResourceBundle() hinzugefügt wurde. | IResourceManager | ||
getString(bundleName:String, resourceName:String, parameters:Array = null, locale:String = null):String
Ruft den Wert einer festgelegten Ressource als String ab, nachdem die Platzhalter durch festgelegte Werte ersetzt wurden. | IResourceManager | ||
Ruft den Wert einer festgelegten Ressource als Array von Strings ab. | IResourceManager | ||
Ruft den Wert einer festgelegten Ressource als uint-Wert ab. | IResourceManager | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | IEventDispatcher | ||
Initialisiert die localeChain-Eigenschaft des ResourceManager mithilfe eines Algorithmus, der die Liste des Betriebssystems der vom Benutzer bevorzugten Gebietsschemas mit der Liste des in der SWF verfügbaren Gebietsschemas vergleicht. | IResourceManager | ||
installCompiledResourceBundles(applicationDomain:ApplicationDomain, locales:Array, bundleNames:Array, useWeakReference:Boolean = false):Array
Erstellt Instanzen aller ResourceBundle-Unterklassen, die in der SWF kompiliert wurden, und fügt sie dem ResourceManager hinzu. | IResourceManager | ||
loadResourceModule(url:String, update:Boolean = true, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
Beginnt ein Ressourcenmodul zu laden, welches ResourceBundles enthält. | IResourceManager | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | IEventDispatcher | ||
Entfernt ein bestimmtes ResourceBundle aus dem ResourceManager, sodass auf seine Ressourcen durch ResourceManager-Methoden wie z. B. getString() nicht mehr zugegriffen werden kann. | IResourceManager | ||
Entfernt alle ResourceBundles eines bestimmten Gebietsschemas aus dem ResourceManager, sodass auf seine Ressourcen durch ResourceManager-Methoden wie z. B. getString() nicht mehr zugegriffen werden kann. | IResourceManager | ||
Entlädt ein geladenes Ressourcenmodul. | IResourceManager | ||
Löst ein Änderungsereignis vom ResourceManager aus. | IResourceManager | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | IEventDispatcher |
localeChain | Eigenschaft |
localeChain:Array
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein Array von Gebietsschemastrings, z. B. [ „en_US“ ]
, welches ein oder mehrere Gebietsschemas festlegt, die nach Ressourcen durchsucht werden können.
Wenn Sie die ResourceManager-Methoden getObject()
, getString()
, getStringArray()
, getNumber()
, getInt()
, getUint()
, getBoolean()
oder getClass()
aufrufen, um den Wert einer Ressource abzurufen, legen Sie einen Bundle-Namen und einen Ressourcennamen fest, aber kein Gebietsschema. Der ResourceManager beginnt mit dem ersten Gebietsschema in der localeChain
und sucht nach einem ResourceBundle mit dem festgelegten Bundle-Namen für dieses Gebietsschema. Wenn ein ResourceBundle existiert und sich die festgelegte Methode darin befindet, wird der Wert dieser Ressource zurückgegeben. Wenn nicht, fährt der ResourceManager mit den anderen Gebietsschemas in localeChain
fort.
Dieses Schema erlaubt das Vorhandensein von Gebietsschemas, welche nicht den kompletten Satz an lokalisierten Ressourcen aufweisen. Beispiel: Wenn Sie Ihre Anwendung in indischem Englisch statt US-Englisch lokalisieren, brauchen Sie lediglich diejenigen Ressourcen für das Gebietsschema en_IN
bereitzustellen, deren Schreibweise oder Gebrauch vom US-Englischen abweicht. Anschließend setzen Sie die localeChain
-Eigenschaft auf [ "en_IN", "en_US" ]
.
Viele Frameworkklassen gehen davon aus, dass sie von den Gebietsschemas immer die Ressourcen beziehen können, die sie erwarten. Wenn dies nicht funktioniert, geben sie einen Fehler aus. Deshalb müssen Sie sicherstellen, dass localeChain
immer einen vollständigen Satz Ressourcen enthält. Wenn Sie keine vollständige Lokalisierung aller Frameworkressourcen und Ihrer eigenen Anwendungen durchgeführt haben, behalten Sie das Gebietsschema "en_US"
am Ende Ihrer localeChain
bei, um dies sicherzustellen.
Das Einstellen dieser Eigenschaft veranlasst ResourceManager, ein "change"
-Ereignis auszulösen.
Implementierung
public function get localeChain():Array
public function set localeChain(value:Array):void
addResourceBundle | () | Methode |
public function addResourceBundle(resourceBundle:IResourceBundle, useWeakReference:Boolean = false):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fügt ResourceManager ein bestimmtes ResourceBundle zu, sodass auf seine Ressourcen durch ResourceManager-Methoden wie z. B. getString()
zugegriffen werden kann.
Parameter
resourceBundle:IResourceBundle — Das hinzuzufügende ResourceBundle.
| |
useWeakReference:Boolean (default = false ) — Bestimmt, ob ResourceManager einen schwachen Verweis auf das Ressourcenpaket beibehält. Wenn useWeakReference den Wert true aufweist, stellt ResourceManager einen schwachen Verweis auf das Ressourcenpaket zur Verfügung. Wenn der Aufrufer die Verwendung eines schwachen Verweises wählt, liegt es in der Verantwortung des Aufrufers, einen starken Verweis auf das Ressourcenpaket beizubehalten, damit es nicht vom Garbagekollektor frühzeitig entfernt wird. Wenn useWeakReference den Wert false aufweist, stellt ResourceManager einen starken Verweis auf das Ressourcenpaket zur Verfügung, damit es nicht vom Garbagekollektor entfernt wird.
Wenn ein Flex-Modul oder eine Flex-Unteranwendung dem ResourceManager kompilierte Ressourcenpakete automatisch hinzufügt, ruft das Modul bzw. die Unteranwendung |
findResourceBundleWithResource | () | Methode |
public function findResourceBundleWithResource(bundleName:String, resourceName:String):IResourceBundle
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Sucht das Gebietsschema in localeChain
für die festgelegte Ressource und gibt das erste ResourceBundle zurück, das gefunden wurde. Wenn die Ressource nicht gefunden wird, gibt die Methode null
zurück.
Parameter
bundleName:String — Ein Bundle-Name, z. B. "MyResources" .
| |
resourceName:String — Der Name einer Ressource im ResourcBundle.
|
IResourceBundle — Das erste ResourceBundle in localeChain , welches die festgelegten Ressourcen oder null enthält.
|
getBoolean | () | Methode |
public function getBoolean(bundleName:String, resourceName:String, locale:String = null):Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ruft den Wert einer festgelegten Ressource als booleschen Wert ab.
Diese Methode ruft zuerst getString()
auf und konvertiert das Ergebnis in Kleinbuchstaben. Es wird true
zurückgegeben, wenn das Ergebnis"true"
war. und false
, wenn nicht.
Wenn die festgelegte Ressource nicht gefunden wurde, wird false
zurückgegeben.
Parameter
bundleName:String — Der Name des ResourceBundle.
| |
resourceName:String — Der Name einer Ressource im ResourcBundle.
| |
locale:String (default = null ) — Ein bestimmtes Gebietsschema, welches für das Nachschlagen benutzt wird oder null , um in allen Gebietsschemas von localeChain zu suchen. Dieser Parameter ist optional und standardmäßig null . Diesen Wert müssen Sie nur selten festlegen.
|
Boolean — Der Ressourcenwert als boolescher Wert oder false , wenn kein Wert gefunden wurde.
|
getBundleNamesForLocale | () | Methode |
public function getBundleNamesForLocale(locale:String):Array
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt ein Array von Strings zurück, welches die Bundle-Namen für alle ResourceBundle-Objekte festlegt, welche im ResourceManager vorliegen, und welche zum festgelegten Gebietsschema gehören.
Die Reihenfolge der Bundle-Namen in diesem Array ist nicht festgelegt.
Parameter
locale:String — Ein Gebietsschemastring, z. B. "en_US" .
|
Array — Ein Array von Bundle-Namen.
|
Verwandte API-Elemente
getClass | () | Methode |
public function getClass(bundleName:String, resourceName:String, locale:String = null):Class
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ruft den Wert einer festgelegten Ressource als Klasse ab.
Diese Methode ruft getObject()
auf und erzwingt das Schreiben einer Klasse mithilfe des as
-Operator. Das Ergebnis ist null
, wenn der Ressourcenwert kein Klassenverweis war. Dies ist nützlich, wenn Sie Zeilen wie diese
IMAGE=Embed("image.jpg") BUTTON_SKIN=ClassReference("skins.ButtonSkin_en_US")
in eine Eigenschaftendatei geschrieben haben und die Klasse beziehen möchten, welche die Embed()
oder dieClassReference()
-Direktive erzeugt hat.
Wenn die festgelegte Ressource nicht gefunden wurde, wird null
zurückgegeben.
Parameter
bundleName:String — Der Name des ResourceBundle.
| |
resourceName:String — Der Name einer Ressource im ResourcBundle.
| |
locale:String (default = null ) — Ein bestimmtes Gebietsschema, welches für das Nachschlagen benutzt wird oder null , um in allen Gebietsschemas von localeChain zu suchen. Dieser Parameter ist optional und standardmäßig null . Diesen Wert müssen Sie nur selten festlegen.
|
Class — Der Ressourcenwert als Class oder null , wenn kein Wert gefunden wurde.
|
getInt | () | Methode |
public function getInt(bundleName:String, resourceName:String, locale:String = null):int
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ruft den Wert einer festgelegten Ressource als int-Wert ab.
Diese Methode ruft getObject()
auf und wandelt das Ergebnis in einen int-Wert um. Dies ist nützlich, wenn Sie Zeilen wie diese
MINIMUM=5
in eine Eigenschaftendatei geschrieben haben und den Wert 5 statt "5"
erhalten möchten.
Wenn die festgelegte Ressource nicht gefunden wurde, gibt die Methode 0 zurück.
Parameter
bundleName:String — Der Name des ResourceBundle.
| |
resourceName:String — Der Name einer Ressource im ResourcBundle.
| |
locale:String (default = null ) — Ein bestimmtes Gebietsschema, welches für das Nachschlagen benutzt wird oder null , um in allen Gebietsschemas von localeChain zu suchen. Dieser Parameter ist optional und standardmäßig null . Diesen Wert müssen Sie nur selten festlegen.
|
int — Der Ressourcenwert als int-Wert oder 0, wenn der Wert nicht gefunden wurde.
|
getLocales | () | Methode |
public function getLocales():Array
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt ein Array von Strings zurück, welches alle Gebietsschemas festlegt, für welche ResourceBundle-Objekte im ResourceManager existieren.
Die Reihenfolge der Gebietsschemas in diesem Array ist nicht festgelegt.
RückgabewerteArray — Ein Array von Gebietsschemastrings.
|
getNumber | () | Methode |
public function getNumber(bundleName:String, resourceName:String, locale:String = null):Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ruft den Wert einer festgelegten Ressource als Zahl ab.
Diese Methode ruft getObject()
auf und wandelt das Ergebnis in eine Zahl um. Dies ist nützlich, wenn Sie Zeilen wie diese
LONGITUDE=170.3
in eine Eigenschaftendatei geschrieben haben und den Wert 170.3 statt "170.3"
erhalten möchten.
Wenn die festgelegte Ressource nicht gefunden wurde, gibt die Methode NaN
zurück.
Parameter
bundleName:String — Der Name des ResourceBundle.
| |
resourceName:String — Der Name einer Ressource im ResourcBundle.
| |
locale:String (default = null ) — Ein bestimmtes Gebietsschema, welches für das Nachschlagen benutzt wird oder null , um in allen Gebietsschemas von localeChain zu suchen. Dieser Parameter ist optional und standardmäßig null . Diesen Wert müssen Sie nur selten festlegen.
|
Number — Der Ressourcenwert als Zahl oder NaN , wenn kein Wert gefunden wurde.
|
getObject | () | Methode |
public function getObject(bundleName:String, resourceName:String, locale:String = null):*
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ruft den Wert einer festgelegten Ressource als Objekt ab.
Der Wert wird genauso zurückgegeben, wie er im content
-Objekt des ResourceBundle gespeichert ist. Es findet keine Konvertierung statt. Wenn die Ressource aus einer Eigenschaftendatei kompiliert wurde, ist der Ressourcenwert des content
-Objekts immer ein String, es sei denn, dass die Embed()
oder die ClassReference()
-Direktive, welche in diesem Fall eine Klasse ist, benutzt wurde. Verwenden Sie getString()
-, getStringArray()
-, getNumber()
-, getInt()
-, getUint()
-, getBoolean()
- und getClass()
-Methoden, um den Wert in speziellere Typen zu konvertieren.
Wenn die festgelegte Ressource nicht gefunden wurde, gibt die Methode undefined
zurück.
Parameter
bundleName:String — Der Name des ResourceBundle.
| |
resourceName:String — Der Name einer Ressource im ResourcBundle.
| |
locale:String (default = null ) — Ein bestimmtes Gebietsschema, welches für das Nachschlagen benutzt wird oder null , um in allen Gebietsschemas von localeChain zu suchen. Dieser Parameter ist optional und standardmäßig null . Diesen Wert müssen Sie nur selten festlegen.
|
* — Der Ressourcenwert, genau wie im content -Objekt gespeichert, oder undefined , wenn die Ressource nicht gefunden wurde.
|
getPreferredLocaleChain | () | Methode |
public function getPreferredLocaleChain():Array
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt ein Array von Strings zurück, welches alle Gebietsschemas, für welche ResourceBundle-Objekte im ResourceManager existieren, festlegt. Geordnet nach den von Capabilities.language
oder Capabilities.languages
gemeldeten Benutzereinstellungen.
Array — Ein Array von Gebietsschemastrings.
|
getResourceBundle | () | Methode |
public function getResourceBundle(locale:String, bundleName:String):IResourceBundle
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt ein ResourceBundle mit dem festgelegten locale
und bundleName
zurück, welches zuvor zum ResourceManager mit addResourceBundle()
hinzugefügt wurde. Wenn kein ResourceBundle existiert, dann gibt diese Methode null
zurück.
Parameter
locale:String — Ein Gebietsschemastring, z. B. "en_US" .
| |
bundleName:String — Ein Bundle-Name, z. B. "MyResources" .
|
IResourceBundle — ResourceBundle mit festgelegtem locale und bundleName , wenn vorhanden, oder null , wenn nicht.
|
Verwandte API-Elemente
getString | () | Methode |
public function getString(bundleName:String, resourceName:String, parameters:Array = null, locale:String = null):String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ruft den Wert einer festgelegten Ressource als String ab, nachdem die Platzhalter durch festgelegte Werte ersetzt wurden.
Diese Methode ruft getObject()
auf und wandelt das Ergebnis in einen String um.
Wenn ein parameters
-Array an diese Methode übergeben wird, werden die darin enthaltenen Parameter in Strings konvertiert und dann für die Platzhalter "{0}"
, "{1}"
(usw.) im String eingesetzt, bevor er zurückgegeben wird.
Wenn die festgelegte Ressource nicht gefunden wurde, wird null
zurückgegeben.
Parameter
bundleName:String — Der Name des ResourceBundle.
| |
resourceName:String — Der Name einer Ressource im ResourcBundle.
| |
parameters:Array (default = null ) — Ein Array von Parametern, die die Platzhalter ersetzen. Jeder Parameter wird mithilfe der toString() -Methode in einen String konvertiert, bevor er ersetzt wird.
| |
locale:String (default = null ) — Ein bestimmtes Gebietsschema, welches für das Nachschlagen benutzt wird oder null , um in allen Gebietsschemas von localeChain zu suchen. Dieser Parameter ist optional und standardmäßig null . Diesen Wert müssen Sie nur selten festlegen.
|
String — Der Ressourcenwert als String oder null , wenn kein Wert gefunden wurde.
|
getStringArray | () | Methode |
public function getStringArray(bundleName:String, resourceName:String, locale:String = null):Array
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ruft den Wert einer festgelegten Ressource als Array von Strings ab.
Die Methode geht davon aus, dass der Ressourcenwert ein String ist und durch Komma abgegrenzte Elementlisten enthält. Die getString()
-Methode wird aufgerufen, teilt den String an den Kommas in Elemente und entfernt Leerzeichen vor und nach jedem Element. Dies ist nützlich, wenn Sie Zeilen wie diese
COUNTRIES=India, China, Japan
In einer Eigenschaftendatei sollte der Wert [ "India", "China", "Japan" ]
statt "India, China, Japan"
bezogen werden.
Wenn die festgelegte Ressource nicht gefunden wurde, wird null
zurückgegeben.
Parameter
bundleName:String — Der Name des ResourceBundle.
| |
resourceName:String — Der Name einer Ressource im ResourcBundle.
| |
locale:String (default = null ) — Ein bestimmtes Gebietsschema, welches für das Nachschlagen benutzt wird oder null , um in allen Gebietsschemas von localeChain zu suchen. Dieser Parameter ist optional und standardmäßig null . Diesen Wert müssen Sie nur selten festlegen.
|
Array — Der Ressourcenwert als Array von Strings odernull , wenn der Wert nicht gefunden wurde.
|
getUint | () | Methode |
public function getUint(bundleName:String, resourceName:String, locale:String = null):uint
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ruft den Wert einer festgelegten Ressource als uint-Wert ab.
Diese Methode ruft die getObject()
-Methode auf und wandelt das Ergebnis in einen uint-Wert um. Dies ist nützlich, wenn Sie Zeilen wie diese
MINIMUM=5
in eine Eigenschaftendatei geschrieben haben und den Wert 5 statt "5"
erhalten möchten.
Wenn die festgelegte Ressource nicht gefunden wurde, gibt die Methode 0 zurück.
Parameter
bundleName:String — Der Name des ResourceBundle.
| |
resourceName:String — Der Name einer Ressource im ResourcBundle.
| |
locale:String (default = null ) — Ein bestimmtes Gebietsschema, welches für das Nachschlagen benutzt wird oder null , um in allen Gebietsschemas von localeChain zu suchen. Dieser Parameter ist optional und standardmäßig null . Diesen Wert müssen Sie nur selten festlegen.
|
uint — Der Ressourcenwert als uint oder 0, wenn der Wert nicht gefunden wurde.
|
initializeLocaleChain | () | Methode |
public function initializeLocaleChain(compiledLocales:Array):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Initialisiert die localeChain
-Eigenschaft des ResourceManager mithilfe eines Algorithmus, der die Liste des Betriebssystems der vom Benutzer bevorzugten Gebietsschemas mit der Liste des in der SWF verfügbaren Gebietsschemas vergleicht.
Beispiel: Wenn der Benutzer im Betriebssystem angegeben hat, dass er Französisch bevorzugt, und die SWF für die Gebietsschemas en_US, fr_FR und de_DE kompiliert wurde, wird die localeChain
so eingestellt, dass das erste Gebietsschema darin fr_FR ist.
Diese Methode wird nur von Klassen verwendet, die die IFlexModuleFactory-Schnittstelle implementieren.
Parameter
compiledLocales:Array — Ein Array von Strings, welches die Gebietsschemas festlegt, für welche die SWF kompiliert wurde.
|
Verwandte API-Elemente
installCompiledResourceBundles | () | Methode |
public function installCompiledResourceBundles(applicationDomain:ApplicationDomain, locales:Array, bundleNames:Array, useWeakReference:Boolean = false):Array
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Erstellt Instanzen aller ResourceBundle-Unterklassen, die in der SWF kompiliert wurden, und fügt sie dem ResourceManager hinzu.
Beispiel: Wenn der locales
-Parameter [ "en_US", "ja_JP" ] und der bundleNames
-Parameter [ "core", "controls" ] ist, werden vier Ressourcenpakete installiert.
Diese Methode wird nur von Klassen verwendet, die die IFlexModuleFactory-Schnittstelle implementieren.
Parameter
applicationDomain:ApplicationDomain — Die ApplicationDomain, welche die Ressourcenpaketklassen nach Namen sucht.
| |
locales:Array — Ein Array von Strings, welches die Gebietsschemas festlegt, für welche die SWF kompiliert wurde.
| |
bundleNames:Array — Ein Array von Strings, welches die Namen der Ressourcenpakete festlegt, die in die SWF kompiliert wurden.
| |
useWeakReference:Boolean (default = false ) — Ein Flag, das festlegt, ob die Ressourcenpakete im ResourceManager mithilfe eines schwachen Verweises installiert werden sollen.
|
Array — Ein Array der ResourceBundle-Instanzen, das erstellt und dem ResourceManager hinzugefügt wurde.
|
Verwandte API-Elemente
loadResourceModule | () | Methode |
public function loadResourceModule(url:String, update:Boolean = true, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Beginnt ein Ressourcenmodul zu laden, welches ResourceBundles enthält.
Jeder Aufruf dieser Methode gibt ein neues ereignisauslösendes Objekt zurück, an welchem Sie den Ladefortschritt ablesen können und erfahren, ob dieser erfolgreich abgeschlossen wurde oder mit einem Fehler endete. Dieses Objekt löst ResourceEvent.PROGRESS
, ResourceEvent.COMPLETE
und ResourceEvent.ERROR
-Ereignisse aus.
Wenn das Modul geladen wurde, werden die ResourceBundles dem ResourceManager hinzugefügt, aber localeChain
. bleibt unverändert. Wenn der update
-Parameter true
ist, wird die update()
-Methode aufgerufen.
Parameter
url:String — Die URL, von welcher das Ressourcenmodul zu laden ist.
| |
update:Boolean (default = true ) — Ob die update() -Methode aufgerufen werden soll, wenn das Modul den Ladevorgang beendet hat.
| |
applicationDomain:ApplicationDomain (default = null ) — Die ApplicationDomain, welche an die load() -Methode der IModuleInfo-Klasse übergeben wurde, die das Ressourcenmodul lädt. Dieser Parameter ist optional und standardmäßig null .
| |
securityDomain:SecurityDomain (default = null ) — Die SecurityDomain, welche an die load() -Methode der IModuleInfo-Klasse übergeben wurde, die das Ressourcenmodul lädt. Dieser Parameter ist optional und standardmäßig null .
|
IEventDispatcher — Ein Objekt, welches mit diesem bestimmten Ladevorgang verknüpft ist, welcher ResourceEvent.PROGRESS , ResourceEvent.COMPLETE und ResourceEvent.ERROR -Ereignisse auslöst.
|
Verwandte API-Elemente
removeResourceBundle | () | Methode |
public function removeResourceBundle(locale:String, bundleName:String):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Entfernt ein bestimmtes ResourceBundle aus dem ResourceManager, sodass auf seine Ressourcen durch ResourceManager-Methoden wie z. B. getString()
nicht mehr zugegriffen werden kann.
Parameter
locale:String — Ein Gebietsschemastring, z. B. "en_US" .
| |
bundleName:String — Ein Bundle-Name, z. B. "MyResources" .
|
Verwandte API-Elemente
removeResourceBundlesForLocale | () | Methode |
public function removeResourceBundlesForLocale(locale:String):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Entfernt alle ResourceBundles eines bestimmten Gebietsschemas aus dem ResourceManager, sodass auf seine Ressourcen durch ResourceManager-Methoden wie z. B. getString()
nicht mehr zugegriffen werden kann.
Parameter
locale:String — Ein Gebietsschemastring, z. B. "en_US" .
|
Verwandte API-Elemente
unloadResourceModule | () | Methode |
public function unloadResourceModule(url:String, update:Boolean = true):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Entlädt ein geladenes Ressourcenmodul.
Durch Entladen des Moduls werden dessen ResourceBundles aus dem ResourceManager entfernt, dielocaleChain
bleibt jedoch unverändert. Wenn der update
-Parameter true
ist, wird die update()
-Methode aufgerufen.
Parameter
url:String — Die URL, die zum Laden des Ressourcenmoduls verwendet wurde.
| |
update:Boolean (default = true ) — Gibt an, ob die update() -Methode aufgerufen werden soll, wenn das Modul den Entladevorgang beendet hat.
|
update | () | Methode |
public function update():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Löst ein change
-Ereignis vom ResourceManager aus.
Dies führt dazu, dass bindbare Ausdrücke erneut ermitteln, ob die folgenden ResourceManager-Methoden beteiligt sind: getObject()
, getString()
, getStringArray()
, getNumber()
, getInt()
, getUint()
, getBoolean()
oder getClass()
.
Dies löst auch die Ausführung der resourcesChanged()
-Methode von UIComponent, Formatierer oder Validator aus. Viele Komponenten implementieren diese Methode, um ihren Status anhand der neusten Ressourcen zu aktualisieren.
Tue Jun 12 2018, 10:04 AM Z