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 |
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 |
Methode | Definiert von | ||
---|---|---|---|
ChangeWatcher(access:Object, handler:Function, commitOnly:Boolean = false, next:ChangeWatcher = null)
Konstruktor. | ChangeWatcher | ||
[statisch]
Ermöglicht es zu bestimmen, ob der Host ein datenbindendes Ereignis für die Eigenschaft bereitstellt. | ChangeWatcher | ||
[statisch]
Gibt alle Bindungsereignisse für eine bindbare Eigenschaft des Hostobjekts zurück. | ChangeWatcher | ||
Ruft den aktuellen Wert der überwachten Eigenschaft oder Eigenschaftenkette ab, oder „null“, wenn das Hostobjekt „null“ ist. | ChangeWatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt „true“ zurück, wenn jeder Watcher in der Kette wenigstens einem Change-Ereignis zugeordnet ist. | ChangeWatcher | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Setzt die ChangeWatcher-Instanz zurück, um ein neues Hostobjekt zu verwenden. | ChangeWatcher | ||
Legt die Prozedurfunktion fest. | ChangeWatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Löst die ChangeWatcher-Instanz und ihre Prozedurfunktion vom aktuellen Host. | ChangeWatcher | ||
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 |
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.
ChangeWatcher | () | 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.
access:Object | |
handler:Function | |
commitOnly:Boolean (default = false )
| |
next:ChangeWatcher (default = null )
|
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.
|
Boolean — true , wenn der host Change-Ereignisse für name bereitstellt.
|
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.
|
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.cRü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.
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 |
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 diereset() -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:
Hinweis: Die Eigenschaft oder Eigenschaften, die im | |
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 | |
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.
|
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
Tue Jun 12 2018, 10:04 AM Z