IResourceManager  - AS3 Flex

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.

Fügt ResourceManager ein bestimmtes ResourceBundle zu, sodass auf seine Ressourcen durch ResourceManager-Methoden wie z. B. getString() zugegriffen werden kann.

Parameter

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

Ruft den Wert einer festgelegten Ressource als booleschen Wert ab.

Diese Methode ruft zuerst getString() auf und konvertiert das Ergebnis in Kleinbuchstaben. Es wird truezurückgegeben, wenn das Ergebnis"true" war. und false, wenn nicht.

Wenn die festgelegte Ressource nicht gefunden wurde, wird false zurückgegeben.

Parameter

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

Verwandte API-Elemente

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

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

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.

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

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

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.

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 nullzurück.

Parameter

Verwandte API-Elemente

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

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

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

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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

Verwandte API-Elemente

Entfernt ein bestimmtes ResourceBundle aus dem ResourceManager, sodass auf seine Ressourcen durch ResourceManager-Methoden wie z. B. getString() nicht mehr zugegriffen werden kann.

Parameter

Verwandte API-Elemente

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

Verwandte API-Elemente

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

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.