ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.resources 

ResourceBundle  - AS3 Flex

Paketmx.resources
Klassepublic class ResourceBundle
VererbungResourceBundle Inheritance Object
Implementiert IResourceBundle

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stellt eine Implementierung der IResourceBundle-Schnittstelle bereit. IResourceManager- und IResourceBundle-Schnittstellen arbeiten zusammen, um Internationalisierungsunterstützung für Flex-Anwendungen bereitzustellen.

Normalerweise besitzt eine Flex-Anwendung mehrere Instanzen dieser Klasse, welche alle von einer einzigen Instanz der ResourceManager-Klasse verwaltet werden. Mehrere ResourceBundle-Instanzen für mehrere Gebietsschemas sind möglich, jeweils eine für jedes Gebietsschema. Es kann mehrere ResourceBundle-Instanzen mit verschiedenen Bundle-Namen geben.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  bundleName : String
[schreibgeschützt] Ein Name, der dieses ResourceBundle identifiziert, z. B. „MyResources“.
ResourceBundle
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  content : Object
[schreibgeschützt] Ein Objekt, welches Schlüssel-/Wertepaare für die Ressourcen im ResourceBundle enthält.
ResourceBundle
  locale : String
[schreibgeschützt] Das Gebietsschema, für welches die Ressourcen des Bundles lokalisiert wurden.
ResourceBundle
Öffentliche Methoden
 MethodeDefiniert von
  
ResourceBundle(locale:String = null, bundleName:String = null)
Konstruktor.
ResourceBundle
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Geschützte Methoden
 MethodeDefiniert von
  
Wenn eine Eigenschaftendatei in ein ResourceBundle kompiliert wurde, generiert der MXML-Compiler automatisch eine Unterklasse des ResourceBundle.
ResourceBundle
Eigenschaftendetails

bundleName

Eigenschaft
bundleName:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ein Name, der dieses ResourceBundle identifiziert, z. B. "MyResources".

Die Eigenschaft „schreibgeschützt“ wird eingestellt, wenn ein ResourceBundle erstellt wird.

ResourceBundles, welche automatisch aus kompilierten Eigenschaftendateien erstellt wurden, haben Bundle-Namen, die auf diesen Dateinamen basieren. Beispiel: Eine Eigenschaftendatei mit dem Namen MyResources.properties erstellt ein ResourceBundle, dessen bundleName "MyResources" ist.

ResourceManager kann mehrere Bundles mit dem gleichen bundleName verwalten, solange sie verschiedene Werte für ihre locale-Eigenschaften besitzen.



Implementierung
    public function get bundleName():String

content

Eigenschaft 
content:Object  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ein Objekt, welches Schlüssel-/Wertepaare für die Ressourcen im ResourceBundle enthält.

Im Allgemeinen sollten Sie auf Ressourcen über IResourceManager-Methoden wie z. B. getString() zugreifen, statt direkt im ResourceBundle auf sie zuzugreifen. Falls Sie Ihre eigenen ResourceBundles programmgesteuert erstellen, können Sie diese mit den Ressourcen wie folgt initialisieren:

      var rb:IResourceBundle = new ResourceBundle("fr_FR", "MyResources");
      rb.content["LANGUAGE"] = "Francais";
      rb.content["GREETING"] = "Bonjour";
      

Wenn ein ResourceBundle durch Kompilieren einer Eigenschaftendatei erstellt wurde, sind ihre Werte entweder Strings oder Klassen. Beispiel: Wenn die Eigenschaftendatei Folgendes enthält:

      LANGUAGE=English
      MINIMUM_AGE=18
      ENABLED=true
      LOGO=Embed("logo.png")
      

ist der Wert der LANGUAGE-Ressource der String "English", der Wert der MINIMUM_AGE-Ressource der String "18", der Wert der ENABLED-Ressource der String "true" und der Wert der LOGO-Ressource ist eine Klasse, welche die eingebettete PNG-Datei enthält.

Sie können IResourceManager-Methoden wie z. B. getInt() und getBoolean() verwenden, um Ressourcenstrings wie z. B. "18" und "true" in den vom Code erwarteten Typ zu konvertieren.



Implementierung
    public function get content():Object

locale

Eigenschaft 
locale:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das Gebietsschema, für welches die Ressourcen des Bundles lokalisiert wurden. Dies ist ein String wie "en_US" für US-Englisch.

Die Eigenschaft „schreibgeschützt“ wird eingestellt, wenn ein ResourceBundle erstellt wird.

ResourceBundles, die automatisch aus kompilierten Eigenschaftendateien erstellt wurden, besitzen Gebietsschemas, die auf der -compiler.locale-Option des mxmlc- oder compc-Compilers basieren. Beispiel: Sie kompilieren Ihre Anwendung mit der Option -compiler.locale=en_US,ja_JP und Sie haben -compiler.source-path=resources/{locale} festgelegt, sodass die Ressourcen Ihrer Anwendung, welche sich in resources/en_US/MyResources.properties und resources/ja_JP/MyResources.properties befinden, gefunden werden. Ihre Anwendung besitzt damit zwei ResourceBundles, deren bundleName "MyResources" lautet. Ein locale mit der Bezeichnung "en_US", das andere locale mit "ja_JP".



Implementierung
    public function get locale():String
Konstruktordetails

ResourceBundle

()Konstruktor
public function ResourceBundle(locale:String = null, bundleName:String = null)

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor.

Parameter
locale:String (default = null) — Ein Gebietsschemastring, z. B. "en_US".
 
bundleName:String (default = null) — Ein Name, der dieses Bundle identifiziert, z. B. "MyResources".
Methodendetails

getContent

()Methode
protected function getContent():Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wenn eine Eigenschaftendatei in ein ResourceBundle kompiliert wurde, generiert der MXML-Compiler automatisch eine Unterklasse des ResourceBundle. Die Unterklasse setzt diese Methode außer Kraft, um ein Objekt zurückzugeben, welches Schlüssel-/Wertepaare für die Ressourcen des Bundles enthält.

Wenn Sie Ihre eigene ResourceBundle-Instanz erzeugen, können Sie die Schlüssel-/Wertepaare des content-Objekts festlegen.

Rückgabewerte
Object — Das Objekt, welches Schlüssel-/Wertepaare für die Ressourcen des Bundle enthält.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.