BindingUtils - Guide de référence de l’API Adobe ActionScript® 3 (AS3 Flex)

Package	mx.binding.utils
Classe	public class BindingUtils
Héritage	BindingUtils Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

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.

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		bindProperty(site:Object, prop:String, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [statique] Lie une propriété publique, prop sur l’objet site, à une propriété ou chaîne de propriétés liable.	BindingUtils
		bindSetter(setter:Function, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [statique] Lie une fonction d’accesseur d’initialisation, Set, à une propriété ou chaîne de propriétés liable.	BindingUtils
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Détails de la méthode

bindProperty

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Lie une propriété publique, prop sur l’objet site, à une propriété ou chaîne de propriétés liable. Si une instance ChangeWatcher est créée avec succès, prop est initialisé sur la valeur actuelle de l’argument chain.

Paramètres

	`site:Object` — Objet définissant la propriété à lier à l’argument `chain`.

	`prop:String` — Nom 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.

	`host:Object` — Objet 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.

	`chain:Object` — Valeur 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"])`. 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.

	`commitOnly:Boolean` (default = `false`) — Dé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.

	`useWeakReference:Boolean` (default = `false`) — Dé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.

Valeur renvoyée

ChangeWatcher — Instance ChangeWatcher, si au moins un nom de propriété a été spécifié au niveau de l’argument chain ; dans le cas contraire, null.

bindSetter

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Lie une fonction d’accesseur d’initialisation, Set, à une propriété ou chaîne de propriétés liable. Si une instance 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.

Paramètres

	`setter:Function` — Méthode d’accesseur d’initialisation à invoquer avec un argument de la valeur actuelle de l’argument `chain` lorsque cette valeur change.

	`host:Object` — Hô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.

	`chain:Object` — Nom de la propriété ou chaîne de propriétés. Pour plus d’informations, voir la méthode `bindProperty()`.

	`commitOnly:Boolean` (default = `false`) — Dé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()`.

	`useWeakReference:Boolean` (default = `false`) — Dé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.

Valeur renvoyée

ChangeWatcher — Instance ChangeWatcher, si au moins un nom de propriété a été spécifié au niveau de l’argument chain ; dans le cas contraire, null.

Informations juridiques | Politique de confidentialité en ligne

BindingUtils - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.binding.utils

bindProperty

bindSetter