mx.binding.utilsChangeWatcher Die ChangeWatcher-Klasse definiert Dienstmethoden, die Sie mit bindbaren Flex-Eigenschaften verwenden können.Object 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. ChangeWatcher Konstruktor.accesshandlercommitOnlyfalsenextmx.binding.utils:ChangeWatchernull Konstruktor. Nicht für die öffentliche Verwendung. Diese Methode wird nur von der watch()-Methode aufgerufen. Siehe watch()-Methode für Parametergebrauch. canWatch Ermöglicht es zu bestimmen, ob der Host ein datenbindendes Ereignis für die Eigenschaft bereitstellt.true, wenn der host Change-Ereignisse für namebereitstellt. hostDer Host der Eigenschaft. Weitere Informationen finden Sie unter der watch()-Methode. nameDer Name der Eigenschaft. Weitere Informationen finden Sie unter der watch()-Methode. commitOnlyfalseAuf true setzen, wenn die Prozedur nur bei Committing-Change-Ereignissen übernommen werden soll. Weitere Informationen finden Sie unter der watch()-Methode. 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.

getEvents Gibt alle Bindungsereignisse für eine bindbare Eigenschaft des Hostobjekts zurück.Objekt mit der Form { eventName: isCommitting, ... }, welches alle Change-Ereignisse für diese Eigenschaft enthält. hostDer Host der Eigenschaft. Weitere Informationen finden Sie unter der watch()-Methode. nameName der Eigenschaft oder der Eigenschaftenkette. Weitere Informationen finden Sie unter der watch()-Methode. commitOnlyfalseSteuert das Einschließen von Non-Commiting-Change-Ereignissen im zurückgegebenen Wert. Gibt alle Bindungsereignisse für eine bindbare Eigenschaft des Hostobjekts zurück. getValue Ruft den aktuellen Wert der überwachten Eigenschaft oder Eigenschaftenkette ab, oder „null“, wenn das Hostobjekt „null“ ist.Der aktuelle Wert der überwachten Eigenschaft oder Eigenschaftenkette. 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

isWatching Gibt „true“ zurück, wenn jeder Watcher in der Kette wenigstens einem Change-Ereignis zugeordnet ist.true, wenn jeder Watcher in der Kette wenigstens einem Change-Ereignis zugeordnet ist. 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. reset Setzt die ChangeWatcher-Instanz zurück, um ein neues Hostobjekt zu verwenden.newHostDer neue Host der Eigenschaft. Weitere Informationen finden Sie unter der watch()-Methode. 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. setHandler Legt die Prozedurfunktion fest.handlerDie Prozedurfunktion. Dieses Argument darf nicht „null“ sein. Legt die Prozedurfunktion fest. unwatch Löst die ChangeWatcher-Instanz und ihre Prozedurfunktion vom aktuellen Host. 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 Erzeugt und startet eine ChangeWatcher-Instanz.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. mx.binding.utils:ChangeWatcherhostDas 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. chainEin 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.

handlerEine 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.

mx.events.PropertyChangeEvent

useWeakReference (Standard = „false“) Bestimmt, ob der Verweis auf den Host stark oder schwach ist. (Standard = „false“) Bestimmt, ob der Verweis auf den Host stark oder schwach ist. Ein starker Verweis (Standard) verhindert, dass der Host von einem Garbagekollektor entfernt wird. Ein schwacher Verweis hingegen nicht. BindingUtils Die BindingUtils-Klasse definiert Dienstmethoden, die Datenbindung aus ActionScript durchführen.Object 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. bindProperty Bindet die öffentliche Eigenschaft „prop“ des Siteobjekts an eine bindbare Eigenschaft oder Eigenschaftenkette.Eine ChangeWatcher-Instanz, wenn mindestens ein Eigenschaftsname für das chain-Argument festgelegt wurde oder „null“, wenn nicht. mx.binding.utils:ChangeWatchersiteDas an chain zu bindende Objekt, welches die Eigenschaft definiert. propDer 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. hostDas Objekt, welches die Eigenschaft oder Eigenschaftenkette hostet, die überwacht werden soll. chainEin 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.

commitOnlyfalsetrue, 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. useWeakReferencefalseBestimmt, ob der Verweis auf den Host stark oder schwach ist. Ein starker Verweis (Standard) verhindert, dass der Host von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht. Hinzugefügt für Flex 4. 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. bindSetter Bindet eine Set-Funktion (Setter) an eine bindbare Eigenschaft oder Eigenschaftenkette.Eine ChangeWatcher-Instanz, wenn mindestens ein Eigenschaftsname für das chain-Argument festgelegt wurde oder „null“, wenn nicht. mx.binding.utils:ChangeWatchersetterSetmethode, welche mit einem Argument des aktuellen chain-Wertes aufgerufen wird, wenn dieser Wert sich ändert. hostDer Host der Eigenschaft. Weitere Informationen finden Sie unter der bindProperty()-Methode. chainName der Eigenschaft oder der Eigenschaftenkette. Weitere Informationen finden Sie unter der bindProperty()-Methode. commitOnlyfalseAuf true setzen, wenn die Prozedur nur für das Übernehmen von Change-Ereignissen aufgerufen werden soll. Weitere Informationen finden Sie unter der bindProperty()-Methode. useWeakReferencefalseBestimmt, ob der Verweis auf den Host stark oder schwach ist. Ein starker Verweis (Standard) verhindert, dass der Host von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht. Hinzugefügt für Flex 4. 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.