BindingUtils - Adobe ActionScript® 3 (AS3 Flex) API-Referenz

Paket	mx.binding.utils
Klasse	public class BindingUtils
Vererbung	BindingUtils Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die BindingUtils-Klasse definiert Dienstmethoden, die Datenbindung aus ActionScript durchführen. Sie können die in dieser Klasse definierten Methoden verwenden, um Datenbindungen zu konfigurieren.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		bindProperty(site:Object, prop:String, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [statisch] Bindet die öffentliche Eigenschaft „prop“ des Siteobjekts an eine bindbare Eigenschaft oder Eigenschaftenkette.	BindingUtils
		bindSetter(setter:Function, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [statisch] Bindet eine Set-Funktion (Setter) an eine bindbare Eigenschaft oder Eigenschaftenkette.	BindingUtils
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Methodendetails

bindProperty

()

Methode

 public static function bindProperty(site:Object, prop:String, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bindet die öffentliche Eigenschaft, prop des site-Objekts an eine bindbare Eigenschaft oder Eigenschaftenkette. Wenn eine ChangeWatcher-Instanz erzeugt wurde, wird prop mit dem aktuellen chain-Wert initialisiert.

Parameter

	`site:Object` — Das an `chain` zu bindende Objekt, welches die Eigenschaft definiert.

	`prop:String` — Der Name der öffentlichen Eigenschaft, welcher im zu bindenden `site`-Objekt definiert wird. Die Eigenschaft erhält den aktuellen `chain`-Wert, sobald sich der `chain`-Wert ändert.

	`host:Object` — Das Objekt, welches die Eigenschaft oder Eigenschaftenkette hostet, die überwacht werden soll. Der `Host` verwaltet eine Liste von `Websites`, die bei einer Änderung von `prop` aktualisiert werden.

	`chain:Object` — Ein Wert, der die zu überwachende Eigenschaft oder Kette festlegt. Gültige Werte sind: Ein String, der den Namen einer öffentlichen, bindbaren Eigenschaft des Hostobjekts enthält. Ein Objekt der Form: `{ name: Eigenschaftsname , getter: function(host) { return host[property name] } }`. Dieses Objekt muss sowohl den Namen als auch die Get-Funktion für eine öffentliche, bindbare Eigenschaft des Hostobjekts enthalten. Ein nicht leeres Array, welches eine Kombination der ersten beiden Optionen enthält, die eine Kette von bindbaren Eigenschaften darstellt, auf welche vom Host zugegriffen werden kann. Beispiel: Um die Eigenschaft `host.a.b.c` zu binden, rufen Sie die Methode als `bindProperty(site, prop, host, ["a","b","c"])` auf. Hinweis: Die Eigenschaft oder Eigenschaften, die im `chain`-Argument benannt werden, müssen öffentlich sein, da die `describeType()`-Methode alle Informationen über nichtöffentliche Eigenschaften unterdrückt, einschließlich der Bindbarkeitsmetadaten, welche der ChangeWatcher scannt, um die Change-Ereignisse zu finden, welche für eine gegebene Eigenschaft bereitgestellt wurden. Jedoch kann mit der Get-Funktion, die bei Verwendung der oben beschriebenen `{ name, getter }`-Argumentform bereitgestellt wird, ein willkürlicher berechneter Wert mit der benannten (öffentlichen) Eigenschaft verknüpft werden.

	`commitOnly:Boolean` (default = `false`) — `true`, wenn die Prozedur nur für Committing-Change-Ereignisse aufgerufen werden soll; `false`, wenn die Prozedur sowohl für Committing- als auch für Non-Committing-Change-Ereignisse aufgerufen werden soll. Hinweis: Das Vorhandensein von Non-Committing-Change-Ereignissen für eine Eigenschaft wird durch das `[NonCommittingChangeEvent(<Ereignisname>)]`-Metadatentag angezeigt. Normalerweise werden diese Tags verwendet, um abgestimmte Wertänderungen anzuzeigen, z. B. Modifikationen in einem Textfeld vor der Bestätigung.

	`useWeakReference:Boolean` (default = `false`) — Bestimmt, ob der Verweis auf die `Website` stark oder schwach ist. Ein starker Verweis (Standard) verhindert, dass die `Website` von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht. Hinzugefügt für Flex 4.

Rückgabewerte

ChangeWatcher — Eine ChangeWatcher-Instanz, wenn mindestens ein Eigenschaftsname für das chain-Argument festgelegt wurde oder „null“, wenn nicht.

bindSetter

()

Methode

 public static function bindSetter(setter:Function, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bindet eine Set-Funktion (Setter) an eine bindbare Eigenschaft oder Eigenschaftenkette. Wenn eine ChangeWatcher-Instanz erfolgreich erstellt wurde, wird die Set-Funktion aufgerufen. Die Set-Funktion muss folgende Funktionssignatur aufweisen:

      function mySetterFunction(object:Object):void {
          //Do whatever you want with the value of the bound property.
      }

Dabei enthält object den aktuellen Wert von chain.

Parameter

	`setter:Function` — Setmethode, welche mit einem Argument des aktuellen `chain`-Wertes aufgerufen wird, wenn dieser Wert sich ändert.

	`host:Object` — Der Host der Eigenschaft. Weitere Informationen finden Sie unter der `bindProperty()`-Methode. Der `Host` verwaltet eine Liste von `Settern`, die bei einer Änderung von `prop` aktualisiert werden.

	`chain:Object` — Name der Eigenschaft oder der Eigenschaftenkette. Weitere Informationen finden Sie unter der `bindProperty()`-Methode.

	`commitOnly:Boolean` (default = `false`) — Auf `true` setzen, wenn die Prozedur nur für das Übernehmen von Change-Ereignissen aufgerufen werden soll. Weitere Informationen finden Sie unter der `bindProperty()`-Methode.

	`useWeakReference:Boolean` (default = `false`) — Bestimmt, ob der Verweis auf den `Setter` stark oder schwach ist. Ein starker Verweis (Standard) verhindert, dass der `Setter` von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht. Hinzugefügt für Flex 4.

Rückgabewerte

ChangeWatcher — Eine ChangeWatcher-Instanz, wenn mindestens ein Eigenschaftsname für das chain-Argument festgelegt wurde oder „null“, wenn nicht.

Rechtliche Hinweise | Onlinedatenschutzerklärung

BindingUtils - AS3 Flex

Klassen x

bindProperty

bindSetter