ComboBox  - AS3 Flex

Spécifie une fonction de rappel utilisée pour effectuer une recherche dans la liste d’éléments lorsque l’utilisateur saisit des caractères dans la zone d’invite. Lorsque l’utilisateur saisit des caractères, la zone déroulante du contrôle s’ouvre et met en évidence l’élément de la liste qui correspond le mieux aux caractères saisis.

La fonction référencée par cette propriété accepte une chaîne d’entrée et renvoie l’index des éléments dans le fournisseur de données correspondant à l’entrée. Les éléments sont renvoyés sous forme de vecteur. <int> d’index dans le fournisseur de données.

La fonction de rappel doit présenter la signature suivante :

        function myMatchingFunction(comboBox:ComboBox, inputText:String):Vector.<int>

Si la valeur de cette propriété est null, le contrôle ComboBox trouve des correspondances en utilisant l’algorithme par défaut. Par défaut, si une chaîne saisie de longueur n équivaut au n premiers caractères d’un élément (la casse étant ignorée), elle est considérée comme étant une correspondance de cet élément. Par exemple, « aRiz » correspond à « Arizona », ce qui n’est pas le cas de « riz ».

Pour désactiver la recherche, créez une fonction de rappel qui renvoie un vecteur vide. <int>.

La valeur par défaut est null.

Spécifie une fonction de rappel pour convertir une nouvelle valeur entrée dans la zone d’invite vers le même type de données que les éléments de données dans le fournisseur de données. La fonction référencée par cette propriété est appelée lorsque le texte dans la zone d’invite est validé et n’est pas détecté dans le fournisseur de données.

La fonction de rappel doit présenter la signature suivante :

        function myLabelToItem(value:String):Object

Emplacement auquel valeur est la chaîne saisie dans la zone d’invite. La fonction renvoie un objet qui est le même type que les éléments du fournisseur de données.

La fonction de rappel par défaut renvoie value.

Nombre maximal de caractères saisis par l’utilisateur que la zone d’invite peut contenir. La valeur 0 correspond à l’absence de limite.

La valeur par défaut est 0.

Si la valeur est true, la liste déroulante s’ouvre lorsque l’utilisateur édite la zone d’invite.

La valeur par défaut est true.

Texte à afficher si l’entrée de texte a la valeur null.

Le texte d’invite s’affiche lors de la création initiale du contrôle. Le texte d’invite disparaît lorsque le contrôle obtient le focus, lorsque l’entrée de texte n’est pas nulle ou lorsqu’un élément est sélectionné dans la liste. Le texte d’invite réapparaît lorsque le contrôle perd le focus, mais uniquement si aucun texte n’a été saisi (si la valeur du champ de texte est la chaîne vide ou de valeur null).

Vous pouvez changer le style du texte d’invite avec les feuilles de style CSS. Si le contrôle comporte un texte d’invite et n’est pas désactivé, le style est défini par le pseudo-sélecteur normalWithPrompt. Si le contrôle est désactivé, les styles définis par le pseudo-sélecteur disabledWithPrompt sont utilisés.

L’exemple de CSS suivant modifie la couleur du texte d’invite dans les contrôles TextInput. Le contrôle ComboBox utilise un contrôle TextInput comme sous-composant pour le texte d’invite et d’entrée, ce qui signifie que son texte d’invite change lorsque vous utilisez cette feuille de style CSS :

      @namespace s "library://ns.adobe.com/flex/spark";
      s|TextInput:normalWithPrompt {
          color: #CCCCFF;
      }
      

La valeur par défaut est null.

Indique le jeu de caractères que l’utilisateur peut saisir dans la zone d’invite. Par défaut, l’utilisateur peut saisir des caractères, ce qui correspond à la valeur d’une chaîne vide.

La valeur par défaut est "".