ChangeWatcher

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die ChangeWatcher-Klasse definiert Dienstmethoden, die Sie mit bindbaren Flex-Eigenschaften verwenden können. Mit diesen Methoden können Sie eine Ereignisprozedur definieren, die ausgeführt wird, sobald eine bindbare Eigenschaft aktualisiert wird.

Ö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
		useWeakReference : Boolean Bestimmt, ob der Verweis auf die Prozedur stark oder schwach ist.	ChangeWatcher

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		ChangeWatcher(access:Object, handler:Function, commitOnly:Boolean = false, next:ChangeWatcher = null) Konstruktor.	ChangeWatcher
		canWatch(host:Object, name:String, commitOnly:Boolean = false):Boolean [statisch] Ermöglicht es zu bestimmen, ob der Host ein datenbindendes Ereignis für die Eigenschaft bereitstellt.	ChangeWatcher
		getEvents(host:Object, name:String, commitOnly:Boolean = false):Object [statisch] Gibt alle Bindungsereignisse für eine bindbare Eigenschaft des Hostobjekts zurück.	ChangeWatcher
		getValue():Object Ruft den aktuellen Wert der überwachten Eigenschaft oder Eigenschaftenkette ab, oder „null“, wenn das Hostobjekt „null“ ist.	ChangeWatcher
		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
		isWatching():Boolean Gibt „true“ zurück, wenn jeder Watcher in der Kette wenigstens einem Change-Ereignis zugeordnet ist.	ChangeWatcher
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		reset(newHost:Object):void Setzt die ChangeWatcher-Instanz zurück, um ein neues Hostobjekt zu verwenden.	ChangeWatcher
		setHandler(handler:Function):void Legt die Prozedurfunktion fest.	ChangeWatcher
		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
		unwatch():void Löst die ChangeWatcher-Instanz und ihre Prozedurfunktion vom aktuellen Host.	ChangeWatcher
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		watch(host:Object, chain:Object, handler:Function, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [statisch] Erzeugt und startet eine ChangeWatcher-Instanz.	ChangeWatcher

Eigenschaftendetails

useWeakReference

Eigenschaft

public var useWeakReference:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bestimmt, ob der Verweis auf die Prozedur stark oder schwach ist. Ein starker Verweis (Standard) verhindert, dass die Prozedur von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht.

Der Standardwert ist false.

Konstruktordetails

()

Konstruktor

public function ChangeWatcher(access:Object, handler:Function, commitOnly:Boolean = false, next:ChangeWatcher = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor. Nicht für die öffentliche Verwendung. Diese Methode wird nur von der watch()-Methode aufgerufen. Siehe watch()-Methode für Parametergebrauch.

Parameter

	`access:Object`

	`handler:Function`

	`commitOnly:Boolean` (default = `false`)

	`next:ChangeWatcher` (default = `null`)

Methodendetails

canWatch

()

Methode

public static function canWatch(host:Object, name:String, commitOnly:Boolean = false):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ermöglicht es zu bestimmen, ob der Host ein datenbindendes Ereignis für die Eigenschaft bereitstellt.

Hinweis: Eigenschaftenketten werden nicht von der canWatch()-Methode unterstützt. Sie werden von der watch()-Methode unterstützt.

Parameter

	`host:Object` — Der Host der Eigenschaft. Weitere Informationen finden Sie unter der `watch()`-Methode.

	`name:String` — Der Name der Eigenschaft. Weitere Informationen finden Sie unter der `watch()`-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 `watch()`-Methode.

Rückgabewerte

Boolean — true, wenn der host Change-Ereignisse für namebereitstellt.

getEvents

()

Methode

public static function getEvents(host:Object, name:String, commitOnly:Boolean = false):Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt alle Bindungsereignisse für eine bindbare Eigenschaft des Hostobjekts zurück.

Parameter

	`host:Object` — Der Host der Eigenschaft. Weitere Informationen finden Sie unter der `watch()`-Methode.

	`name:String` — Name der Eigenschaft oder der Eigenschaftenkette. Weitere Informationen finden Sie unter der `watch()`-Methode.

	`commitOnly:Boolean` (default = `false`) — Steuert das Einschließen von Non-Commiting-Change-Ereignissen im zurückgegebenen Wert.

Rückgabewerte

Object — Objekt mit der Form { eventName: isCommitting, ... }, welches alle Change-Ereignisse für diese Eigenschaft enthält.

getValue

()

Methode

public function getValue():Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ruft den aktuellen Wert der überwachten Eigenschaft oder Eigenschaftenkette ab, oder „null“, wenn das Hostobjekt „null“ ist. Beispiel:

      watch(obj, ["a","b","c"], ...).getValue() === obj.a.b.c

Rückgabewerte

Object — Der aktuelle Wert der überwachten Eigenschaft oder Eigenschaftenkette.

isWatching

()

Methode

public function isWatching():Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt true zurück, wenn jeder Watcher in der Kette wenigstens einem Change-Ereignis zugeordnet ist. Beachten Sie, dass dieisWatching()-Methode mit dem Host variiert, da verschiedene Hosts verschiedene Change-Ereignisse für die vom Watcher gewählte Eigenschaft bereitstellen.

Rückgabewerte

Boolean — true, wenn jeder Watcher in der Kette wenigstens einem Change-Ereignis zugeordnet ist.

reset

()

Methode

public function reset(newHost:Object):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Setzt die ChangeWatcher-Instanz zurück, um ein neues Hostobjekt zu verwenden. Sie können diese Methode aufrufen, um eine Watcher-Instanz für einen anderen Host wiederzuverwenden.

Parameter

newHost:Object — Der neue Host der Eigenschaft. Weitere Informationen finden Sie unter der watch()-Methode.

setHandler

()

Methode

public function setHandler(handler:Function):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Legt die Prozedurfunktion fest.

Parameter

handler:Function — Die Prozedurfunktion. Dieses Argument darf nicht „null“ sein.

unwatch

()

Methode

public function unwatch():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Löst die ChangeWatcher-Instanz und ihre Prozedurfunktion vom aktuellen Host. Sie können die reset()-Methode verwenden, um die ChangeWatcher-Instanz erneut zuzuordnen oder dieselbe Eigenschaft oder Kette für ein anderes Hostobjekt zu überwachen.

watch

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Erzeugt und startet eine ChangeWatcher-Instanz. Eine einzelne ChangeWatcher-Instanz kann eine Eigenschaft oder Eigenschaftenkette überwachen. Eine Eigenschaftenkette ist eine Abfolge von Eigenschaften, auf die von einem Hostobjekt zugegriffen werden kann. Beispiel: Der Ausdruck obj.a.b.c enthält die Eigenschaftenkette (a, b, c).

Parameter

	`host:Object` — Das Objekt, welches die Eigenschaft oder Eigenschaftenkette hostet, die überwacht werden soll. Sie können die`reset()`-Methode verwenden, um den Wert des `host`-Arguments zu ändern, nachdem Sie die ChangeWatcher-Instanz erzeugt haben. Der `Host` verwaltet eine Liste von `Prozeduren`, die bei einer Änderung von `prop` aufgerufen 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[name] } }`. Das Objekt enthält den Namen einer öffentlichen, bindbaren Eigenschaft und einer Get-Funktion für diese Eigenschaft. Ein nicht leeres Array, welches eine beliebige Kombination der beiden ersten Optionen enthält. Dies stellt eine Kette bestehend aus bindbaren Eigenschaften dar, auf welche über den Host zugegriffen werden kann. Beispiel: Um die Eigenschaft `host.a.b.c` zu überwachen, rufen Sie die Methode als `watch(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.

	`handler:Function` — Eine Ereignisprozedurfunktion, die aufgerufen wird, wenn der Wert der überwachten Eigenschaft (oder jeder beliebigen Eigenschaft in einer überwachten Kette) modifiziert wird. Die Modifikation wird signalisiert, sobald ein beliebiges Hostobjekt in der Watcherkette ein Ereignis auslöst, welches im `[Bindable]`-Metadatentag für die entsprechend überwachte Eigenschaft festgelegt wurde. Der voreingestellte Ereignisname ist `propertyChange`. Das von der bindbaren Eigenschaft ausgelöste Ereignisobjekt wird ohne Modifikation an diese Prozedurfunktion übergeben. Standardmäßig löst Flex ein Ereignisobjekt des Typs PropertyChangeEvent aus. Sie können jedoch Ihren eigenen Ereignistyp definieren, indem Sie das `[Bindable]`-Metadatentag verwenden, um eine bindbare Eigenschaft zu definieren.

	`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`) — (Standard = „false“) Bestimmt, ob der Verweis auf die `Prozedur` stark oder schwach ist. Ein starker Verweis (Standard) verhindert, dass die `Prozedur` von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht.

Rückgabewerte

ChangeWatcher — Die ChangeWatcher-Instanz, wenn mindestens ein Eigenschaftsname für das chain-Argument festgelegt wurde oder „null“, wenn nicht. Beachten Sie, dass der zurückgegebene Watcher nicht notwendigerweise Change-Ereignisse entdeckt und sich ihnen zugeordnet hat, denn eventuell wurden vom Host für die betreffende Eigenschaft oder Kette keine Change-Ereignisse bereitgestellt. Sie können die isWatching()-Methode verwenden, um den Status des Watchers zu bestimmen.

Verwandte API-Elemente

mx.events.PropertyChangeEvent

Rechtliche Hinweise | Onlinedatenschutzerklärung

ChangeWatcher - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket mx.binding.utils

useWeakReference

ChangeWatcher

canWatch

getEvents

getValue

isWatching

reset

setHandler

unwatch

watch