mx.binding.utilsChangeWatcher La classe ChangeWatcher définit des méthodes d’utilitaire que vous pouvez utiliser avec les propriétés Flex liables.Object La classe ChangeWatcher définit des méthodes d’utilitaire que vous pouvez utiliser avec les propriétés Flex liables. Ces méthodes permettent de définir un gestionnaire d’événements exécuté chaque fois qu’une propriété liable est mise à jour. ChangeWatcher Constructeur.accesshandlercommitOnlyfalsenextmx.binding.utils:ChangeWatchernull Constructeur. Non destiné à une utilisation publique. Cette méthode n’est appelée qu’à partir de la méthode watch(). Voir la méthode watch() pour connaître l’utilisation du paramètre. canWatch Permet de déterminer si l’hôte expose un événement de liaison de données sur la propriété.true si host expose des événements de modification sur name. hostHôte de la propriété. Pour plus d’informations, voir la méthode watch(). nameNom de la propriété. Pour plus d’informations, voir la méthode watch(). commitOnlyfalseDéfini sur true si le gestionnaire ne doit être appelé que lors d’événements change validants. Pour plus d’informations, voir la méthode watch(). Permet de déterminer si l’hôte expose un événement de liaison de données sur la propriété.

REMARQUE : les chaînes de propriétés ne sont pas prises en charge par la méthode canWatch(). Elles sont prises en charge par la méthodewatch().

getEvents Renvoie tous les événements de liaison pour une propriété liable dans l’objet hôte.Objet au format { eventName: isCommitting, } contenant tous les événements change de la propriété. hostHôte de la propriété. Pour plus d’informations, voir la méthode watch(). nameNom de la propriété ou chaîne de propriétés. Pour plus d’informations, voir la méthode watch(). commitOnlyfalseContrôle l’inclusion d’événements change non validants dans la valeur renvoyée. Renvoie tous les événements de liaison pour une propriété liable dans l’objet hôte. getValue Extrait la valeur actuelle de la propriété ou chaîne de propriétés surveillée ou null si l’objet hôte est nul.Valeur actuelle de la propriété ou chaîne de propriétés surveillée. Extrait la valeur actuelle de la propriété ou chaîne de propriétés surveillée ou null si l’objet hôte est nul. Par exemple :

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

isWatching Renvoie true si chaque surveillant dans la chaîne est rattaché à au moins un événement change.true si chaque surveillant dans la chaîne est rattaché à au moins un événement change. Renvoie true si chaque surveillant dans la chaîne est rattaché à au moins un événement change. Notez que la méthode isWatching() varie selon l’hôte, car différents hôtes peuvent exposer différents événements change pour la propriété choisie du surveillant. reset Réinitialise cette occurrence ChangeWatcher pour utiliser un nouvel objet hôte.newHostNouvel hôte de la propriété. Pour plus d’informations, voir la méthode watch(). Réinitialise cette occurrence ChangeWatcher pour utiliser un nouvel objet hôte. Vous pouvez appeler cette méthode pour réutiliser une occurrence de surveillant sur un hôte différent. setHandler Définit la fonction du gestionnaire.handlerFonction du gestionnaire. L’argument ne doit pas être nul. Définit la fonction du gestionnaire. unwatch Détache cette occurrence ChangeWatcher et sa fonction de gestionnaire de l’hôte actuel. Détache cette occurrence ChangeWatcher et sa fonction de gestionnaire de l’hôte actuel. Vous pouvez utiliser la méthode reset() pour réattacher l’occurrence ChangeWatcher ou surveiller la même propriété ou chaîne sur un objet hôte différent. watch Crée et démarre une occurrence ChangeWatcher.Occurrence ChangeWatcher, si au moins un nom de propriété a été spécifié au niveau de l’argument chain ; dans le cas contraire, null. Notez qu’il n’est pas garanti que le surveillant renvoyé a découvert et s’est rattaché avec succès aux événements change, car il se peut qu’aucun n’ait été exposé par l’hôte sur la propriété ou chaîne donnée. Vous pouvez utiliser la méthode isWatching() pour déterminer l’état du surveillant. mx.binding.utils:ChangeWatcherhostObjet qui héberge la propriété ou chaîne de propriétés à surveiller. Vous pouvez utiliser la méthode reset() pour changer la valeur de l’argument host une fois l’occurrence ChangeWatcher créée. L’hôte host conserve une liste de gestionnaires handler à appeler lorsque prop change. chainValeur spécifiant la propriété ou chaîne à surveiller. Les valeurs légales sont les suivantes :

Chaîne contenant le nom d’une propriété liable publique de l’objet hôte.
Objet au format : { name: nom de propriété, getter: function(host) { return host[name] } }. L’objet contient le nom d’une propriété liable publique et une fonction servant d’accesseur de lecture pour cette propriété.
Tableau non vide contenant une combinaison des deux premières options. Cela représente une chaîne de propriétés liables accessibles à partir de l’hôte. Par exemple, pour surveiller la propriété host.a.b.c, appelez la méthode comme suit : watch(host, ["a","b","c").

Remarque : la ou les propriétés nommées dans l’argument chain doivent être publiques, car la méthode describeType() supprime toutes les informations concernant les propriétés non publiques, y compris les métadonnées de capacité de liaison que ChangeWatcher analyse afin de rechercher les événements change exposés pour une propriété donnée. Cependant, la fonction d’accesseur de lecture fournie lors de l’utilisation du format d’argument { name, getter } décrit ci-dessus peut être utilisée pour associer une valeur calculée arbitraire à la propriété (publique) nommée.

handlerFonction de gestionnaire d’événements appelée lorsque la valeur de la propriété surveillée (ou d’une propriété dans une chaîne surveillée) est modifiée. La modification est signalée lorsqu’un objet hôte dans la chaîne du surveillant distribue l’événement ayant été spécifié dans la balise de métadonnées [Bindable] de cet objet hôte pour la propriété surveillée correspondante. L’événement par défaut est nommé propertyChange.

L’objet d’événement distribué par la propriété liable est transmis à cette fonction de gestionnaire sans modification. Par défaut, Flex distribue un objet d’événement de type PropertyChangeEvent. Cependant, vous pouvez définir votre propre type d’événement lorsque vous utilisez la balise de métadonnées [Bindable] pour définir une propriété liable.

mx.events.PropertyChangeEvent

useWeakReference Détermine si la référence au gestionnaire est forte ou faible.false Détermine si la référence au gestionnaire handler est forte ou faible. Une référence forte (valeur par défaut) empêche le nettoyage du gestionnaire handler. Cela n’est pas le cas avec une référence faible. BindingUtils La classe BindingUtils définit des méthodes d’utilitaire pour lier des données depuis ActionScript.Object La classe BindingUtils définit des méthodes d’utilitaire pour lier des données depuis ActionScript. Vous pouvez utiliser les méthodes définies dans cette classe pour configurer des liaisons de données. bindProperty Lie une propriété publique, prop sur l’objet site, à une propriété ou chaîne de propriétés liable.Occurrence ChangeWatcher, si au moins un nom de propriété a été spécifié au niveau de l’argument chain ; dans le cas contraire, null. mx.binding.utils:ChangeWatchersiteObjet définissant la propriété à lier à l’argument chain. propNom de la propriété publique définie dans l’objet site à lier. La propriété recevra la valeur actuelle de l’argument chain lorsque la valeur de l’argument chain change. hostObjet qui héberge la propriété ou chaîne de propriétés à surveiller. L’hôte host conserve une liste de sites à mettre à jour lorsque prop change. chainValeur spécifiant la propriété ou chaîne à surveiller. Les valeurs légales sont les suivantes :

Chaîne contenant le nom d’une propriété liable publique de l’objet hôte.
Objet au format : { name: nom de propriété, getter: function(host) { return host[nom de propriété] } }. Cet objet doit contenir le nom d’une propriété liable publique de l’objet hôte, ainsi qu’une fonction d’accesseur de lecture pour cette propriété.
Tableau non vide contenant une combinaison des deux premières options et représentant une chaîne de propriétés liables accessible à partir de l’hôte. Par exemple, pour lier la propriétéhost.a.b.c, appelez la méthode de la manière suivante : bindProperty(site, prop, host, ["a","b","c"]).

commitOnlyfalseDéfini sur true si le gestionnaire ne doit être appelé que lors d’événements change validants ; défini sur false si le gestionnaire doit être appelé lors d’événements change validants et non validants. Remarque : la présence d’événements change non validants pour une propriété est indiquée par la balise de métadonnées [NonCommittingChangeEvent(<nom de l’événement>]. Ces balises sont généralement utilisées pour indiquer des modifications de valeur subtiles, telles que des modifications dans un champ de texte avant confirmation. useWeakReferencefalseDétermine si la référence au site est forte ou faible. Une référence forte (valeur par défaut) empêche le nettoyage du site. contrairement à une référence faible. Ajouté pour Flex 4. Lie une propriété publique, prop sur l’objet site, à une propriété ou chaîne de propriétés liable. Si une occurrence ChangeWatcher est créée avec succès, prop est initialisé sur la valeur actuelle de l’argument chain. bindSetter Lie une fonction d’accesseur d’initialisation, Set, à une propriété ou chaîne de propriétés liable.Occurrence ChangeWatcher, si au moins un nom de propriété a été spécifié au niveau de l’argument chain ; dans le cas contraire, null. mx.binding.utils:ChangeWatchersetterMéthode d’accesseur d’initialisation à invoquer avec un argument de la valeur actuelle de l’argument chain lorsque cette valeur change. hostHôte de la propriété. Pour plus d’informations, voir la méthode bindProperty(). L’hôte host conserve une liste de méthodes setter à mettre à jour lorsque prop change. chainNom de la propriété ou chaîne de propriétés. Pour plus d’informations, voir la méthode bindProperty(). commitOnlyfalseDéfini sur true si le gestionnaire ne doit être appelé que lors d’événements change validants. Pour plus d’informations, voir la méthode bindProperty(). useWeakReferencefalseDétermine si la référence à la méthode setter est forte ou faible. Une référence forte (valeur par défaut) empêche le nettoyage de la méthode setter. contrairement à une référence faible. Ajouté pour Flex 4. Lie une fonction d’accesseur d’initialisation, Set, à une propriété ou chaîne de propriétés liable. Si une occurrence ChangeWatcher est bien créée, la fonction de setter est invoquée. Cette fonction doit présenter la signature suivante :

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

où object contient la valeur en cours de la chain.