Package | fl.controls |
Classe | public class ComboBox |
Héritage | ComboBox UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implémente | IFocusManagerComponent |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage. | DisplayObject | ||
alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | DisplayObject | ||
blendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser. | DisplayObject | ||
blendShader : Shader [écriture seule]
Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan. | DisplayObject | ||
buttonMode : Boolean
Spécifie le mode de bouton du sprite. | Sprite | ||
cacheAsBitmap : Boolean
Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur true. | DisplayObject | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
contextMenu : NativeMenu
Spécifie le menu contextuel associé à l’objet. | InteractiveObject | ||
dataProvider : DataProvider
Lit ou définit le modèle de données de la liste d’éléments à afficher. | ComboBox | ||
doubleClickEnabled : Boolean
Spécifie si l’objet reçoit les événements doubleClick. | InteractiveObject | ||
dropdown : List [lecture seule]
Récupère une référence au composant List contenu dans le composant ComboBox. | ComboBox | ||
dropdownWidth : Number
Lit ou définit la largeur maximale de la liste déroulante, en pixels. | ComboBox | ||
dropTarget : DisplayObject [lecture seule]
Spécifie l’objet d’affichage sur lequel le sprite est glissé ou sur lequel il a été déposé. | Sprite | ||
editable : Boolean
Récupère ou définit une valeur booléenne qui indique si le composant ComboBox est modifiable ou en lecture seule. | ComboBox | ||
enabled : Boolean
Récupère ou définit une valeur indiquant si le composant peut accepter une interaction de l’utilisateur. | UIComponent | ||
filters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage. | DisplayObject | ||
focusEnabled : Boolean
Récupère ou définit une valeur booléenne indiquant si le composant peut recevoir le focus après un clic de l’utilisateur sur son entrée. | UIComponent | ||
focusManager : IFocusManager
Récupère ou définit le FocusManager qui contrôle le focus pour ce composant et ses homologues. | UIComponent | ||
focusRect : Object
Spécifie si l’objet affiche un rectangle de focus. | InteractiveObject | ||
graphics : Graphics [lecture seule]
Spécifie l’objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel. | Sprite | ||
height : Number [override]
Récupère ou définit la hauteur du composant, en pixels. | UIComponent | ||
hitArea : Sprite
Désigne un autre sprite qui fera office de zone active d’un sprite. | Sprite | ||
labelField : String
Lit ou définit le nom du champ dans l’objet dataProvider à afficher en tant qu’étiquette dans le champ TextInput et dans la liste déroulante. | ComboBox | ||
labelFunction : Function
Lit ou définit la fonction à utiliser pour obtenir l’étiquette de l’élément. | ComboBox | ||
length : int [lecture seule]
Lit le nombre d’éléments de la liste | ComboBox | ||
loaderInfo : LoaderInfo [lecture seule]
Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. | DisplayObject | ||
mask : DisplayObject
L’objet d’affichage appelant est masqué par l’objet mask spécifié. | DisplayObject | ||
metaData : Object
Obtient les données d’objet de métadonnées de l’occurrence DisplayObject si les données d’meta a été stockée près de la l’occurrence de cette DisplayObject dans le fichier SWF à l’aide d’une balise de4 PlaceObject. | DisplayObject | ||
mouseChildren : Boolean
Détermine si les enfants de l’objet prennent en charge la souris ou les périphériques de saisie utilisateur. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. | InteractiveObject | ||
mouseFocusEnabled : Boolean
Récupère ou définit une valeur indiquant si le composant peut recevoir le focus après un clic de l’utilisateur sur son entrée. | UIComponent | ||
mouseX : Number [lecture seule]
Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | ||
mouseY : Number [lecture seule]
Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | ||
name : String
Indique le nom d’occurrence de DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus. | InteractiveObject | ||
numChildren : int [lecture seule]
Renvoie le nombre d’enfants de l’objet. | DisplayObjectContainer | ||
opaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique. | DisplayObject | ||
parent : DisplayObjectContainer [lecture seule]
Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage. | DisplayObject | ||
prompt : String
Récupère ou définit l’invite du composant ComboBox. | ComboBox | ||
restrict : String
Lit ou définit le jeu de caractères qu’un utilisateur peut entrer dans le champ de texte. | ComboBox | ||
root : DisplayObject [lecture seule]
Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier. | DisplayObject | ||
rotation : Number
Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. | DisplayObject | ||
rotationX : Number
Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | ||
rotationY : Number
Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | ||
rotationZ : Number
Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | ||
rowCount : uint
Lit ou définit le nombre maximum de lignes qui peuvent s’afficher dans une liste déroulante sans barre de défilement. | ComboBox | ||
scale9Grid : Rectangle
Grille de mise à l’échelle en vigueur. | DisplayObject | ||
scaleX : Number [override]
Multiplie la largeur actuelle du composant par un facteur de redimensionnement. | UIComponent | ||
scaleY : Number [override]
Multiplie la hauteur actuelle du composant par un facteur de redimensionnement. | UIComponent | ||
scaleZ : Number
Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement. | DisplayObject | ||
scrollRect : Rectangle
Cadre de sélection du défilement de l’objet d’affichage. | DisplayObject | ||
selectedIndex : int
Lit ou définit l’index de l’élément qui est sélectionné dans une liste à sélection unique. | ComboBox | ||
selectedItem : Object
Lit ou définit la valeur de l’élément qui est sélectionné dans la liste déroulante. | ComboBox | ||
selectedLabel : String [lecture seule]
Récupère la chaîne affichée dans la partie TextInput du composant ComboBox. | ComboBox | ||
softKeyboard : String
Contrôle l’aspect du clavier logiciel. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche (non disponible sur iOS) | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
Contrôle le son à l’intérieur du sprite. | Sprite | ||
stage : Stage [lecture seule]
Scène de l’objet d’affichage. | DisplayObject | ||
tabChildren : Boolean
Détermine si les enfants de l’objet prennent ou non en charge la tabulation. | DisplayObjectContainer | ||
tabEnabled : Boolean
Indique si cet objet est spécifié dans l’ordre de tabulation. | InteractiveObject | ||
tabIndex : int
Spécifie l’ordre de tabulation des objets dans un fichier SWF. | InteractiveObject | ||
text : String
Lit ou définit le texte que la zone de texte contient dans un composant ComboBox modifiable. | ComboBox | ||
textField : fl.controls:TextInput [lecture seule]
Lit une référence au composant TextInput contenu dans le composant ComboBox. | ComboBox | ||
textSnapshot : flash.text:TextSnapshot [lecture seule]
Renvoie un objet TextSnapshot pour l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
transform : flash.geom:Transform
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. | DisplayObject | ||
useHandCursor : Boolean
Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque le pointeur survole un sprite dont la propriété buttonMode est définie sur true. | Sprite | ||
value : String [lecture seule]
Récupère l’étiquette d’un élément présent dans un composant ComboBox modifiable. | ComboBox | ||
visible : Boolean [override]
Récupère ou définit une valeur indiquant si l’occurrence du composant actif est visible. | UIComponent | ||
width : Number [override]
Récupère ou définit la largeur du composant, en pixels. | UIComponent | ||
x : Number [override]
Récupère ou définit la coordonnée x représentant la position du composant le long de l’axe x au sein de son conteneur parent. | UIComponent | ||
y : Number [override]
Récupère ou définit la coordonnée y représentant la position du composant le long de l’axe y au sein de son conteneur parent. | UIComponent | ||
z : Number
Indique la position de coordonnée z le long de l’axe des z de l’occurrence DisplayObject par rapport au conteneur 3D parent. | DisplayObject |
Méthode | Défini par | ||
---|---|---|---|
ComboBox()
Crée une nouvelle occurrence du composant ComboBox. | ComboBox | ||
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. | DisplayObjectContainer | ||
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | ||
Ajoute un élément à la fin de la liste d’éléments. | ComboBox | ||
Insère un élément dans la liste, à l’index spécifié. | ComboBox | ||
Indique si les restrictions de sécurité entraîneraient l’omission des objets d’affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point « point » spécifié. | DisplayObjectContainer | ||
Définit une propriété de style depuis cette occurrence de composant. | UIComponent | ||
Ferme la liste déroulante. | ComboBox | ||
Détermine si l’objet d’affichage spécifié est un enfant de l’occurrence de DisplayObjectContainer ou l’occurrence en tant que telle. | DisplayObjectContainer | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Affiche ou masque l’indicateur de focus dans ce composant. | UIComponent | ||
Déclenche une opération de dessin immédiate, sans tout annuler comme le fait invalidateNow. | UIComponent | ||
Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace. | DisplayObject | ||
Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié. | DisplayObjectContainer | ||
Renvoie l’objet d’affichage enfant portant le nom spécifié. | DisplayObjectContainer | ||
Renvoie la position d’index d’une occurrence enfant de DisplayObject. | DisplayObjectContainer | ||
Récupère l’objet qui détient actuellement le focus. | UIComponent | ||
Récupère l’élément à l’index spécifié. | ComboBox | ||
Renvoie un tableau d’objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes. | DisplayObject | ||
Extrait une propriété de style définie dans la chaîne de recherche de style du composant. | UIComponent | ||
[statique]
Récupère la texture de style par défaut du composant actif. | ComboBox | ||
Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales). | DisplayObject | ||
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales). | DisplayObject | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj. | DisplayObject | ||
Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y. | DisplayObject | ||
Marque une propriété comme non valide, puis redessine le composant dans la prochaine image, sauf spécification contraire. | UIComponent | ||
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 | ||
Extrait la chaîne normalement affichée par l’objet de rendu pour l’objet de données fourni en fonction des propriétés labelField et labelFunction. | ComboBox | ||
Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales). | DisplayObject | ||
Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales). | DisplayObject | ||
[statique]
Fusionne les styles de plusieurs classes en un seul objet. | UIComponent | ||
Déplace le composant à la position spécifiée dans son parent. | UIComponent | ||
Ouvre la liste déroulante. | ComboBox | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime tous les éléments de la liste. | ComboBox | ||
Supprime l’occurrence enfant de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime toutes les occurrences enfants de DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Supprime l’élément spécifié de la liste. | ComboBox | ||
Supprime l’élément présent à l’emplacement d’index spécifié. | ComboBox | ||
Remplace l’élément, à l’index spécifié, par un autre élément. | ComboBox | ||
Affiche un clavier virtuel. | InteractiveObject | ||
Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage. | DisplayObjectContainer | ||
Définit le focus sur ce composant. | UIComponent | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Définit le composant en fonction de la largeur et de la hauteur spécifiées. | UIComponent | ||
Définit une propriété de style pour cette occurrence de composant. | UIComponent | ||
Trie les éléments du fournisseur de données actuel. | ComboBox | ||
Trie les éléments du fournisseur de données actuel en fonction d’un ou plusieurs de ses champs. | ComboBox | ||
Permet à l’utilisateur de faire glisser le sprite spécifié. | Sprite | ||
Permet à l’utilisateur de faire glisser le sprite spécifié sur un périphérique tactile. | Sprite | ||
Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine. | DisplayObjectContainer | ||
Met fin à la méthode startDrag(). | Sprite | ||
Met fin à la méthode startTouchDrag() en vue d’utiliser des périphériques tactiles. | Sprite | ||
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés. | DisplayObjectContainer | ||
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des objets enfant aux deux positions d’index spécifiées dans la liste d’enfants. | DisplayObjectContainer | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Valide et met à jour les propriétés et la mise en forme de cet objet, puis le redessine si nécessaire. | UIComponent | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher |
Evénement | Synthèse | Défini par | ||
---|---|---|---|---|
[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | |||
Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage. | DisplayObject | |||
Envoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | |||
Distribué lorsque l’utilisateur change la sélection dans le composant ComboBox ou, si ce dernier est modifiable, à chaque saisie d’une combinaison de touches par l’utilisateur dans le champ de texte. | ComboBox | |||
Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel. | InteractiveObject | |||
Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsque la liste déroulante se ferme pour une raison quelconque. | ComboBox | |||
Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR. | InteractiveObject | |||
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel. | InteractiveObject | |||
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel. | InteractiveObject | |||
[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | |||
Distribué lorsque l’utilisateur appuie sur le bouton principal d’un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d’InteractiveObject si l’indicateur doubleClickEnabled de cet objet est réglé sur true. | InteractiveObject | |||
Distribué si la propriété editable est définie sur true et que l’utilisateur appuie sur la touche Entrée pendant qu’il tape du texte dans un champ de texte modifiable. | ComboBox | |||
[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image. | DisplayObject | |||
[événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours. | DisplayObject | |||
Distribué après la prise de focus par un objet d’affichage. | InteractiveObject | |||
Distribué après la perte de focus par un objet d’affichage. | InteractiveObject | |||
[événement de diffusion] Distribué après l’exécution des constructeurs des objets d’affichage d’image, mais avant celle des scripts d’image. | DisplayObject | |||
Distribué lorsque l’utilisateur crée un point de contact le long du bord de la surface tactile à l’aide d’une occurrence InteractiveObject (par exemple, en appuyant le long du bord de la surface tactile sur la télécommande Siri Remote pour l’Apple TV). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements tactiles. | InteractiveObject | |||
Distribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire). | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter). | InteractiveObject | |||
Distribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu). | InteractiveObject | |||
Distribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué après que la visibilité du composant soit passée de visible à invisible. | UIComponent | |||
Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME. | InteractiveObject | |||
Définit la valeur de la propriété type d’un objet de l’événement itemRollOut. | ComboBox | |||
Définit la valeur de la propriété type de l’objet d’un événement itemRollOver. | ComboBox | |||
Distribué lorsque l’utilisateur appuie sur une touche. | InteractiveObject | |||
Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier. | InteractiveObject | |||
Distribué lorsque l’utilisateur relâche une touche. | InteractiveObject | |||
Distribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsque la molette d’une souris est actionnée sur une occurrence de InteractiveObject. | InteractiveObject | |||
Distribué à la suite du déplacement du composant. | UIComponent | |||
Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser. | InteractiveObject | |||
Distribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop(). | InteractiveObject | |||
Distribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites. | InteractiveObject | |||
Distribué par un InteractiveObject lorsqu’une opération glisser sort des limites. | InteractiveObject | |||
Distribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites. | InteractiveObject | |||
Distribué au début d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag(). | InteractiveObject | |||
Distribué lors d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag(). | InteractiveObject | |||
Distribué lorsque l’utilisateur clique sur un bouton déroulant pour afficher la liste déroutante. | ComboBox | |||
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne "Coller" dans le menu contextuel. | InteractiveObject | |||
Distribué lorsque l’utilisateur approche un stylet actif de l’écran après le seuil de détection de proximité de l’écran. | InteractiveObject | |||
Distribué lorsque l’utilisateur soulève un stylet actif au-dessus du seuil de détection de proximité de l’écran. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un stylet actif sur l’écran tout en respectant le seuil de détection de proximité. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un stylet actif en dehors de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un stylet actif directement au-dessus de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un stylet actif hors de cet objet InteractiveObject et de l’un de ses enfants, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un stylet actif sur cet objet InteractiveObject de l’extérieur de l’arborescence d’objets de descendants dans la liste d’affichage (tout en respectant le seuil de détection de proximité de l’écran). | InteractiveObject | |||
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage après avoir appuyé sur le bouton sur une occurrence d’InteractiveObject, puis après avoir déplacé le périphérique de pointage hors de l’occurrence d’InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage. | DisplayObject | |||
Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage de la scène, directement ou par l’intermédiaire de la suppression d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | |||
[événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée. | DisplayObject | |||
Distribué à la suite du redimensionnement du composant. | UIComponent | |||
Distribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsque l’utilisateur parcourt la liste déroulante du composant ComboBox. | ComboBox | |||
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit "Sélectionner tout" dans le menu contextuel. | InteractiveObject | |||
Distribué après que la visibilité du composant soit passée de invisible à visible. | UIComponent | |||
Distribué immédiatement après l’affichage du clavier logiciel. | InteractiveObject | |||
Distribué immédiatement avant l’affichage du clavier logiciel. | InteractiveObject | |||
Distribué immédiatement après la disparition du clavier logiciel. | InteractiveObject | |||
Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change. | InteractiveObject | |||
Distribué lorsque l’indicateur tabEnabled de l’objet change. | InteractiveObject | |||
Distribué lorsque la valeur de la propriété tabIndex de l’objet change. | InteractiveObject | |||
Distribué lorsqu’un utilisateur entre un ou plusieurs caractères de texte. | InteractiveObject | |||
Distribué lorsque l’utilisateur touche pour la première fois un périphérique tactile (notamment lorsqu’il pose un doigt sur un téléphone portable ou une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur cesse le contact avec un périphérique tactile (notamment lorsqu’il retire le doigt d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur appuie sur le périphérique, et est continuellement distribué jusqu’au retrait du point de contact. | InteractiveObject | |||
Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un objet d’affichage vers un autre sur un téléphone portable ou une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un se trouvant sur l’objet d’affichage d’un téléphone portable ou une tablette munis d’un écran tactile vers un point se trouvant en dehors de cet objet). | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur lève le point de contact sur la même occurrence d’InteractiveObject sur laquelle le contact a été lancé sur un périphérique tactile (notamment lorsqu’il appuie avec un doigt à partir d’un point de contact unique sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis le retire). | InteractiveObject |
Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.
Style | Description | Défini par | ||
---|---|---|---|---|
buttonWidth | Type: Number Format: Length Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Espace qui sépare le bord droit du composant et le texte représentant l’élément sélectionné, en pixels. Le bouton fait partie de l’enveloppe de l’arrière-plan. La valeur par défaut est 24 . | ComboBox | ||
cellRenderer | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Classe qui fournit le rendu de cellule pour chaque élément du composant. La valeur par défaut est fl.controls.listClasses.CellRenderer . | ComboBox | ||
contentPadding | Type: Number Format: Length Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Remplissage entre le contenu (le composant et la barre de défilement) et le bord extérieur de l’arrière-plan, en pixels. La valeur par défaut est 3 . | ComboBox | ||
disabledAlpha | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Valeur alpha à attribuer à la liste lorsque la propriété enabled est définie sur false .
La valeur par défaut est 0.5 . | ComboBox | ||
disabledSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit l’arrière-plan apparaissant dans le composant ComboBox lorsque la propriété enabled du composant est définie sur false .
La valeur par défaut est ComboBox_disabledSkin . | ComboBox | ||
Type: flash.text.TextFormat Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Objet TextFormat à utiliser pour le rendu de l’étiquette du composant lorsque le bouton est désactivé. | UIComponent | |||
downArrowDisabledSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement lorsqu’il est désactivé. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowDown_disabledSkin . | ComboBox | ||
downArrowDownSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement lorsque vous cliquez sur le bouton flèche. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowDown_downSkin . | ComboBox | ||
downArrowOverSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement lorsque le pointeur de la souris le survole. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowDown_overSkin . | ComboBox | ||
downArrowUpSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowDown_upSkin . | ComboBox | ||
downSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit l’arrière-plan apparaissant dans le composant ComboBox lorsque le bouton de la souris est enfoncé. La valeur par défaut est ComboBox_downSkin . | ComboBox | ||
embedFonts | Type: Boolean Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Indique si des polices vectorielles incorporées sont utilisées pour le rendu du champ de texte. Si cette valeur est true , Flash Player procède au rendu du champ de texte à l’aide des polices vectorielles incorporées. Si cette valeur est false , Flash Player procède au rendu du champ de texte à l’aide des polices de périphérique.
Si vous définissez la propriété false . | ComboBox | ||
Type: Number Format: Length Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Remplissage qui sépare les limites extérieures du composant et les bords extérieurs de l’indicateur du focus, en pixels. | UIComponent | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe à utiliser pour afficher les indicateurs de focus. | UIComponent | |||
overSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit l’arrière-plan apparaissant dans le composant ComboBox lorsque la souris le survole. La valeur par défaut est ComboBox_overSkin . | ComboBox | ||
repeatDelay | Type: Number Format: Time Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nombre de millisecondes d’attente après la première diffusion de l’événement buttonDown et avant l’envoi d’un second événement buttonDown .
La valeur par défaut est 500 . | ComboBox | ||
repeatInterval | Type: Number Format: Time Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Intervalle, en millisecondes, entre les événements buttonDown distribués après le délai spécifié par le style repeatDelay .
La valeur par défaut est 35 . | ComboBox | ||
Type: flash.text.TextFormat Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Objet TextFormat à utiliser pour le rendu de l’étiquette du composant. | UIComponent | |||
textPadding | Type: Number Format: Length Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Espace qui sépare la bordure et le texte représentant l’élément sélectionné, en pixels. La valeur par défaut est 3 . | ComboBox | ||
thumbArrowUpSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe pour le curseur de la barre de défilement. La valeur par défaut est ScrollThumb_upSkin . | ComboBox | ||
thumbDisabledSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe utilisée pour indiquer l’état désactivé du curseur. La valeur par défaut est ScrollThumb_upSkin . | ComboBox | ||
thumbDownSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme habillage du curseur de la barre de défilement lorsque vous cliquez sur le curseur. La valeur par défaut est ScrollThumb_downSkin . | ComboBox | ||
thumbIcon | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme icône du curseur de la barre de défilement. La valeur par défaut est ScrollBar_thumbIcon . | ComboBox | ||
thumbOverSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme habillage du curseur de la barre de défilement lorsque le pointeur de la souris le survole. La valeur par défaut est ScrollThumb_overSkin . | ComboBox | ||
trackDisabledSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe utilisée pour indiquer un rail désactivé. La valeur par défaut est ScrollTrack_Skin . | ComboBox | ||
trackDownSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe utilisée pour indiquer l’état enfoncé d’une enveloppe désactivée. La valeur par défaut est ScrollTrack_Skin . | ComboBox | ||
trackOverSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe utilisée pour indiquer l’état de survol de la souris dans le rail de défilement. La valeur par défaut est ScrollTrack_Skin . | ComboBox | ||
trackUpSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe utilisée pour indiquer l’état relevé de la souris dans le rail de défilement. La valeur par défaut est ScrollTrack_Skin . | ComboBox | ||
upArrowDisabledSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement lorsqu’il est désactivé. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowUp_disabledSkin . | ComboBox | ||
upArrowDownSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement lorsque vous cliquez sur le bouton flèche. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowUp_downSkin . | ComboBox | ||
upArrowOverSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement lorsque le pointeur de la souris le survole. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowUp_overSkin . | ComboBox | ||
upArrowUpSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement. Si vous modifiez l’enveloppe, graphiquement ou par programmation, assurez-vous que la nouvelle a bien la même hauteur (pour les barres de défilement horizontales) ou la même largeur (pour les barres de défilement verticales) que le rail. La valeur par défaut est ScrollArrowUp_upSkin . | ComboBox | ||
upSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit l’arrière-plan du composant ComboBox. La valeur par défaut est ComboBox_upSkin . | ComboBox |
dataProvider | propriété |
dataProvider:DataProvider
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit le modèle de données de la liste d’éléments à afficher. Un fournisseur de données peut être partagé par plusieurs composants à base de listes. Les modifications apportées au fournisseur de données sont immédiatement à la disposition de tous les composants qui l’utilisent comme source de données.
Implémentation
public function get dataProvider():DataProvider
public function set dataProvider(value:DataProvider):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); var cb:ComboBox = new ComboBox(); cb.dataProvider = dp; addChild(cb); var counter = 0; var t:Timer = new Timer(500); t.addEventListener(TimerEvent.TIMER,addAnotherItem); t.start(); function addAnotherItem(e:TimerEvent = null):void { dp.addItem( { label: "Item " + counter++ } ); }
dropdown | propriété |
dropdown:List
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère une référence au composant List contenu dans le composant ComboBox. Aucune occurrence du sous-composant List n’est créé dans le composant ComboBox jusqu’à l’affichage de ce dernier. Cependant, la liste est créée lors de l’accès à la propriété dropdown
.
Implémentation
public function get dropdown():List
dropdownWidth | propriété |
dropdownWidth:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit la largeur maximale de la liste déroulante, en pixels. La valeur par défaut de cette propriété correspond à la largeur du composant ComboBox (largeur de l’occurrence TextInput plus la largeur de l’occurrence BaseButton).
La valeur par défaut est 100.
Implémentation
public function get dropdownWidth():Number
public function set dropdownWidth(value:Number):void
Exemple ( Comment utiliser cet exemple )
dropdownWidth
en fonction de la valeur d’un composant Slider :
import fl.controls.ComboBox; import fl.controls.Slider; import fl.events.SliderEvent; var mySlider:Slider = new Slider(); mySlider.minimum = 50; mySlider.maximum = 150; mySlider.liveDragging = true; mySlider.snapInterval = 5; mySlider.tickInterval = 10; mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); mySlider.move(10, 10); addChild(mySlider); var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.move(10, 30); addChild(myComboBox); mySlider.value = myComboBox.dropdownWidth; function changeHandler(event:SliderEvent):void { myComboBox.dropdownWidth = event.value; }
dropdownWidth
en fonction de la longueur du texte de la liste déroulante :
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"The quick brown fox"}); myComboBox.addItem({label:"Lorem ipsum"}); myComboBox.addItem({label:"Little Miss Muffet"}); myComboBox.addItem({label:"Goldilocks and the three bears"}); myComboBox.addItem({label:"Jack and Jill"}); myComboBox.move(10, 30); addChild(myComboBox); var maxLength:Number = 0; var i:uint; for (i = 0; i < myComboBox.length; i++) { myComboBox.selectedIndex = i; myComboBox.drawNow(); var currText:String = myComboBox.text; var currWidth:Number = myComboBox.textField.textWidth; maxLength = Math.max(currWidth, maxLength); trace(currText, currWidth, maxLength); } myComboBox.selectedIndex = -1; myComboBox.dropdownWidth = maxLength + 20; myComboBox.open();
editable | propriété |
editable:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère ou définit une valeur booléenne qui indique si le composant ComboBox est modifiable ou en lecture seule. La valeur true
indique que le composant ComboBox est modifiable ; la valeur false
indique qu’il n’est l’est pas.
Un composant ComboBox modifiable peut comporter des valeurs qui sont saisies par l’utilisateur dans le champ de texte mais n’apparaissent pas dans la liste déroulante. Ce champ affiche le texte de l’élément de la liste. Lorsqu’un composant ComboBox n’est pas modifiable, toute saisie dans le champ de texte est impossible.
La valeur par défaut est false.
Implémentation
public function get editable():Boolean
public function set editable(value:Boolean):void
Exemple ( Comment utiliser cet exemple )
enter
est distribué :
import fl.controls.ComboBox; import fl.data.DataProvider; import fl.events.ComponentEvent; var dp:DataProvider = new DataProvider(); var myComboBox:ComboBox = new ComboBox; myComboBox.dataProvider = dp; myComboBox.editable = true; myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler); myComboBox.move(10, 10); addChild(myComboBox); function enterHandler(event:ComponentEvent):void { var myCB:ComboBox = event.currentTarget as ComboBox; dp.addItem({label:myCB.text}); myCB.text = ""; myCB.sortItemsOn("label", Array.CASEINSENSITIVE); }
labelField | propriété |
labelField:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit le nom du champ dans l’objet dataProvider
à afficher en tant qu’étiquette dans le champ TextInput et dans la liste déroulante.
Par défaut, le composant affiche la propriété label
de chaque élément dataProvider
. Si les éléments dataProvider
ne contiennent pas de propriété label
, vous pouvez définir la propriété labelField
pour qu’elle utilise une autre propriété.
Remarque : la propriété labelField
n’est pas utilisée lorsque la propriété labelFunction
est définie sur une fonction de rappel.
La valeur par défaut est "label".
Implémentation
public function get labelField():String
public function set labelField(value:String):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
labelField
pour définir un champ d’étiquette personnalisé :
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({firstName:"Jane", lastName:"Doe"}); dp.addItem({firstName:"Bill", lastName:"Smith"}); dp.addItem({firstName:"Tim", lastName:"Jones"}); dp.sortOn(["firstName","lastName"]); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.labelField = "firstName"; myComboBox.move(10, 10); addChild(myComboBox);
labelFunction | propriété |
labelFunction:Function
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit la fonction à utiliser pour obtenir l’étiquette de l’élément.
Par défaut, le composant affiche la propriété label
d’un élément dataProvider
. Certains ensembles de données peuvent ne pas disposer d’un champ label
ou ne pas avoir de champ dont la valeur peut être utilisée en tant qu’étiquette sans modification. Par exemple, un ensemble de données spécifique peut stocker des noms complets et les gérer à l’aide des champs lastName
et firstName
. Dans ce cas, cette propriété permettrait de définir une fonction de rappel qui concatène les valeurs des champs lastName
et firstName
pour former le nom complet à afficher.
Remarque : la propriété labelField
n’est pas utilisée lorsque la propriété labelFunction
est définie sur une fonction de rappel.
Implémentation
public function get labelFunction():Function
public function set labelFunction(value:Function):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
labelFunction
d’une liste sur une fonction qui formate la chaîne à afficher dans chaque cellule :
import fl.data.DataProvider; import fl.controls.List; var myDataProvider:DataProvider = new DataProvider(); myDataProvider.addItem({name:"User A", price:0.43}); myDataProvider.addItem({name:"User B", price:0.34}); var users:List = new List(); users.dataProvider = myDataProvider; users.labelFunction = myLabelFunction; addChild(users); function myLabelFunction(item:Object):String { return item.name + " ($" + item.price.toFixed(2) + ")"; }
labelField
pour définir un champ d’étiquette personnalisé :
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({firstName:"Jane", lastName:"Doe"}); dp.addItem({firstName:"Bill", lastName:"Smith"}); dp.addItem({firstName:"Tim", lastName:"Jones"}); dp.sortOn(["lastName", "firstName"]); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.labelFunction = nameLabelFunction; myComboBox.move(10, 10); addChild(myComboBox); function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
length | propriété |
length:int
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit le nombre d’éléments de la liste Cette propriété appartient au composant List, mais est également accessible à partir d’une occurrence ComboBox.
La valeur par défaut est 0.
Implémentation
public function get length():int
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
rowCount
en fonction du nombre d’éléments qui y sont présents :
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.addItem({label:"Item C"}); myComboBox.addItem({label:"Item D"}); myComboBox.addItem({label:"Item E"}); myComboBox.addItem({label:"Item F"}); myComboBox.rowCount = myComboBox.length / 2; addChild(myComboBox);
rowCount
en fonction du nombre d’éléments qui y sont présents :
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({label:"Item A"}); dp.addItem({label:"Item B"}); dp.addItem({label:"Item C"}); dp.addItem({label:"Item D"}); dp.addItem({label:"Item E"}); dp.addItem({label:"Item F"}); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.rowCount = myComboBox.length / 2; addChild(myComboBox);
prompt | propriété |
prompt:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère ou définit l’invite du composant ComboBox. Cette invite est une chaîne affichée dans la partie TextInput du contrôle ComboBox lorsque la valeur de selectedIndex
est -1. Il s’agit généralement d’une chaîne comme « Sélectionnez un... ». Lorsqu’il n’y a pas d’invite, le composant ComboBox définit la propriété selectedIndex
sur 0 et affiche le premier élément dans la propriété dataProvider
.
La valeur par défaut est "".
Implémentation
public function get prompt():String
public function set prompt(value:String):void
Exemple ( Comment utiliser cet exemple )
prompt
, puis le redimensionne en fonction de la largeur du texte de l’invite :
import fl.controls.ComboBox; var cbStyles:Object = ComboBox.getStyleDefinition(); var bW:Number = cbStyles.buttonWidth as Number var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Please select an option..."; myComboBox.addItem({label:"Option 1"}); myComboBox.addItem({label:"Option 2"}); myComboBox.drawNow(); myComboBox.width = myComboBox.textField.textWidth + 35; myComboBox.dropdownWidth = myComboBox.width - bW; myComboBox.move(10, 10); addChild(myComboBox);
prompt
en fonction du nombre d’éléments présents dans son fournisseur de données :
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({label:"Getting Started"}); dp.addItem({label:"New Features"}); dp.addItem({label:"ActionScript"}); dp.addItem({label:"Components"}); dp.sortOn("label", Array.CASEINSENSITIVE); var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Topics (" + dp.length + ")"; myComboBox.dataProvider = dp; myComboBox.width = 150; myComboBox.move(10, 10); addChild(myComboBox);
restrict | propriété |
restrict:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit le jeu de caractères qu’un utilisateur peut entrer dans le champ de texte. Si la valeur de la propriété restrict
est une chaîne de caractères, vous ne pouvez entrer que les caractères dans la chaîne du champ de texte. La chaîne est lue de gauche à droite. Si la valeur de la propriété restrict
est null
, vous pouvez entrer n’importe quel caractère. Si la valeur de la propriété restrict
est une chaîne vide (""), aucun caractère ne peut être entré. Vous pouvez spécifier une plage à l’aide du caractère (-). Ceci ne limite que l’interaction avec l’utilisateur ; un script peut mettre n’importe quel caractère dans le champ de texte.
La valeur par défaut est null.
Implémentation
public function get restrict():String
public function set restrict(value:String):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
restrict
:
import fl.controls.ComboBox; import fl.data.DataProvider; import fl.events.ComponentEvent; var dp:DataProvider = new DataProvider(); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.editable = true; myComboBox.restrict = "0-9A-F"; myComboBox.textField.maxChars = 6; myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler); myComboBox.move(10, 10); addChild(myComboBox); function enterHandler(event:ComponentEvent):void { var colorStr:String = ComboBox(event.currentTarget).text; var colorNum:uint = uint("0x" + colorStr); dp.addItem({label:colorStr, value:colorNum}); dp.sortOn("value", Array.NUMERIC); event.currentTarget.text = ""; }
rowCount | propriété |
rowCount:uint
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit le nombre maximum de lignes qui peuvent s’afficher dans une liste déroulante sans barre de défilement. Si le nombre d’éléments de la liste déroulante dépasse cette valeur, la liste est redimensionnée et une barre de défilement s’affiche si nécessaire. Lorsque le nombre d’éléments de la liste déroulante est inférieur à cette valeur, la liste déroulante est redimensionnée en fonction du nombre d’éléments qu’elle contient.
Ce comportement diffère de celui du composant List, qui affiche toujours le nombre de lignes spécifié par sa propriété rowCount
, même en cas d’espaces vides.
La valeur par défaut est 5.
Implémentation
public function get rowCount():uint
public function set rowCount(value:uint):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
rowCount
d’un composant ComboBox :
import fl.controls.ComboBox; import fl.controls.Slider; import fl.events.SliderEvent; var numItems:uint = 8; var mySlider:Slider = new Slider(); mySlider.tickInterval = 1; mySlider.snapInterval = 1; mySlider.minimum = 1; mySlider.maximum = numItems; mySlider.liveDragging = true; mySlider.move(10, 10); mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); var myComboBox:ComboBox = new ComboBox(); myComboBox.move(10, 30); addChild(myComboBox); var i:uint; for (i = 0; i < numItems; i++) { myComboBox.addItem({label:"Item " + i}); } function changeHandler(event:SliderEvent):void { myComboBox.rowCount = event.value; }
selectedIndex | propriété |
selectedIndex:int
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit l’index de l’élément qui est sélectionné dans une liste à sélection unique. Une liste à sélection unique est une liste où il n’est possible de sélectionner qu’un seul élément à la fois.
La valeur -1 indique qu’aucun élément n’est sélectionné. En cas de sélections multiples, cette valeur correspond à l’index du dernier élément sélectionné dans le groupe d’éléments sélectionnés.
Lorsque cette propriété est définie à l’aide du code ActionScript, l’élément situé à l’index spécifié remplace la sélection actuelle. Lorsque la sélection est modifiée par le programme, l’objet d’événement change
n’est pas distribué.
La valeur par défaut est 0.
Implémentation
public function get selectedIndex():int
public function set selectedIndex(value:int):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
selectedIndex
de l’occurrence du composant ComboBox :
import fl.controls.ComboBox; import fl.controls.Slider; import fl.data.DataProvider; import fl.events.SliderEvent; var items:XML = <items> <item label="Item 1" /> <item label="Item 2" /> <item label="Item 3" /> <item label="Item 4" /> </items>; var dp:DataProvider = new DataProvider(items); var mySlider:Slider = new Slider(); mySlider.liveDragging = true; mySlider.tickInterval = 1; mySlider.snapInterval = 1; mySlider.minimum = 0; mySlider.maximum = dp.length - 1; mySlider.width = 100; mySlider.move(10, 10); mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.move(10, 30); addChild(myComboBox); function changeHandler(event:SliderEvent):void { myComboBox.selectedIndex = event.value; }
selectedIndex
dans une étiquette sur la scène :
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Please select an item..."; myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.addItem({label:"Item 4"}); myComboBox.width = 150; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = "selectedIndex:" + myComboBox.selectedIndex; myLabel.move(myComboBox.x + myComboBox.width + 10, myComboBox.y); addChild(myLabel); function changeHandler(event:Event):void { myLabel.text = "selectedIndex:" + myComboBox.selectedIndex; }
selectedItem | propriété |
selectedItem:Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit la valeur de l’élément qui est sélectionné dans la liste déroulante. Lorsque l’utilisateur saisit du texte dans la zone de texte d’un composant ComboBox modifiable, la propriété selectedItem
prend la valeur undefined
. Cette propriété n’a de valeur que si l’utilisateur sélectionne un élément dans la liste déroulante ou si ActionScript sert à y sélectionner cet élément. Lorsque le composant ComboBox n’est pas modifiable, la valeur de la propriété selectedItem
est toujours valide. Lorsque la liste déroulante d’un composant ComboBox modifiable ne comporte pas d’éléments, la valeur de cette propriété est null
.
La valeur par défaut est null.
Implémentation
public function get selectedItem():Object
public function set selectedItem(value:Object):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import fl.controls.Button; import fl.controls.ComboBox; import fl.controls.List; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select an item"; myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.addItem({label:"Item C"}); myComboBox.move(10, 10); addChild(myComboBox); var myButton:Button = new Button(); myButton.label = "Copy"; myButton.move(myComboBox.x + myComboBox.width + 10, myComboBox.y); myButton.addEventListener(MouseEvent.CLICK, clickHandler); addChild(myButton); var myList:List = new List(); myList.rowCount = myList.length; myList.selectable = false; myList.move(myComboBox.x, myComboBox.y + myComboBox.height + 10); addChild(myList); function clickHandler(event:MouseEvent):void { if (myComboBox.selectedIndex > -1) { myList.addItem(myComboBox.selectedItem); myList.rowCount = myList.length; } }
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user:"; myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.labelFunction = nameLabelFunction; myComboBox.width = 120; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var firstNameLabel:Label = new Label(); firstNameLabel.text = ""; firstNameLabel.autoSize = TextFieldAutoSize.LEFT; firstNameLabel.move(myComboBox.x, myComboBox.y + myComboBox.height); addChild(firstNameLabel); var lastNameLabel:Label = new Label(); lastNameLabel.text = ""; lastNameLabel.autoSize = TextFieldAutoSize.LEFT; lastNameLabel.move(firstNameLabel.x, firstNameLabel.y + firstNameLabel.height); addChild(lastNameLabel); function changeHandler(event:Event):void { var cb:ComboBox = event.currentTarget as ComboBox; var item:Object = cb.selectedItem; if (cb.selectedIndex > -1) { firstNameLabel.text = item.firstName; lastNameLabel.text = item.lastName; } } function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
selectedLabel | propriété |
selectedLabel:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère la chaîne affichée dans la partie TextInput du composant ComboBox. Cette valeur est calculée à partir des données à l’aide de la propriété labelField
ou labelFunction
.
Implémentation
public function get selectedLabel():String
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
selectedLabel
d’un composant ComboBox :
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user:"; myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.labelFunction = nameLabelFunction; myComboBox.width = 120; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var myLabel:Label = new Label(); myLabel.text = ""; myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height); addChild(myLabel); function changeHandler(event:Event):void { var cb:ComboBox = event.currentTarget as ComboBox; myLabel.text = "selectedLabel: " + cb.selectedLabel; } function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
text | propriété |
text:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit le texte que la zone de texte contient dans un composant ComboBox modifiable. Lorsque les composants ComboBox ne sont pas modifiables, cette valeur est en lecture seule.
La valeur par défaut est "".
Implémentation
public function get text():String
public function set text(value:String):void
Exemple ( Comment utiliser cet exemple )
import fl.controls.ComboBox; import fl.controls.TextArea; import fl.events.ComponentEvent; var myComboBox:ComboBox = new ComboBox(); myComboBox.editable = true; myComboBox.addEventListener(TextEvent.TEXT_INPUT, textInputHandler); myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler); myComboBox.width = 300; myComboBox.move(10, 10); addChild(myComboBox); var myTextArea:TextArea = new TextArea(); myTextArea.wordWrap = false; myTextArea.setSize(300, 200); myTextArea.move(myComboBox.x, myComboBox.y + myComboBox.height + 10); addChild(myTextArea) function textInputHandler(event:TextEvent):void { myTextArea.appendText(event.type + ":\n"); myTextArea.appendText("\t" + event.currentTarget.text + "\n"); myTextArea.appendText("\t" + event.text + "\n"); myTextArea.appendText("\n"); autoScroll(myTextArea); } function enterHandler(event:ComponentEvent):void { myTextArea.appendText(event.type + ":\n"); myTextArea.appendText("\t" + event.currentTarget.text + "\n"); myTextArea.appendText("\n"); autoScroll(myTextArea); } function autoScroll(ta:TextArea):void { ta.verticalScrollPosition = ta.maxVerticalScrollPosition; }
textField | propriété |
textField:fl.controls:TextInput
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit une référence au composant TextInput contenu dans le composant ComboBox. Utilisez cette propriété pour accéder au composant TextInput sous-jacent et le manipuler. Par exemple, vous pouvez utiliser cette propriété pour changer la sélection du champ de texte ou restreindre les caractères pouvant y être saisis.
Implémentation
public function get textField():fl.controls:TextInput
Exemple ( Comment utiliser cet exemple )
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.editable = true; myComboBox.textField.maxChars = 8; myComboBox.move(10, 10); addChild(myComboBox);
import fl.controls.ComboBox; var comicSansTF:TextFormat = new TextFormat(); comicSansTF.font = "Comic Sans MS"; var myComboBox:ComboBox = new ComboBox(); myComboBox.textField.setStyle("textFormat", comicSansTF); myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.addItem({label:"Item C"}); myComboBox.addItem({label:"Item D"}); myComboBox.move(10, 10); addChild(myComboBox);
import fl.controls.ComboBox; import fl.data.DataProvider; var myTextFormat:TextFormat = new TextFormat(); myTextFormat.font = "Comic Sans MS"; myTextFormat.color = 0xFF0000; var fontArray:Array = Font.enumerateFonts(true); fontArray.sortOn("fontName", Array.CASEINSENSITIVE); var dp:DataProvider = new DataProvider(fontArray); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.dropdown.iconField = null; myComboBox.labelField = "fontName"; myComboBox.textField.setStyle("textFormat", myTextFormat); myComboBox.dropdown.setRendererStyle("textFormat", myTextFormat); myComboBox.width = 200; myComboBox.move(10, 10); addChild(myComboBox);
value | propriété |
value:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère l’étiquette d’un élément présent dans un composant ComboBox modifiable. Pour les composants ComboBox qui ne sont pas modifiables, cette propriété lit les données contenues par l’élément.
Implémentation
public function get value():String
Exemple ( Comment utiliser cet exemple )
value
d’un composant ComboBox modifiable :
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user:"; myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.labelFunction = nameLabelFunction; myComboBox.width = 120; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); myComboBox.editable = true; addChild(myComboBox); var myLabel:Label = new Label(); myLabel.text = ""; myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height); addChild(myLabel); function changeHandler(event:Event):void { var cb:ComboBox = event.currentTarget as ComboBox; myLabel.text = "value: " + cb.value; } function nameLabelFunction(item:Object):String { var str:String; if (item == null) { str = myComboBox.value; } else { str = item.lastName + ", " + item.firstName; } return str; }
ComboBox | () | Constructeur |
public function ComboBox()
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Crée une nouvelle occurrence du composant ComboBox.
addItem | () | méthode |
public function addItem(item:Object):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Ajoute un élément à la fin de la liste d’éléments.
Tout élément doit disposer des propriétés label
et data
. Il reste cependant possible d’ajouter à la liste les éléments qui disposent d’autres propriétés. Par défaut, la propriété label
d’un élément permet d’afficher l’étiquette de la ligne. La propriété data
permet de stocker les données de la ligne.
Paramètres
item:Object — Elément à ajouter au fournisseur de données.
|
Eléments de l’API associés
addItemAt | () | méthode |
public function addItemAt(item:Object, index:uint):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Insère un élément dans la liste, à l’index spécifié. Les index des éléments à ou après l’emplacement spécifié sont incrémentés d’une unité.
Paramètres
item:Object — Elément à ajouter à la liste.
| |
index:uint — L’index auquel ajouter l’élément.
|
Eléments de l’API associés
close | () | méthode |
public function close():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Ferme la liste déroulante.
Remarque : l’appel de cette méthode déclenche la diffusion de l’événement close
. Lorsque le composant ComboBox est déjà fermé, l’appel de cette méthode n’a aucun effet.
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
open()
et close()
:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(Event.OPEN, openHandler); myComboBox.addEventListener(Event.CLOSE, closeHandler); addChild(myComboBox); var isOpen:Boolean = false; var timer:Timer = new Timer(1000); timer.addEventListener(TimerEvent.TIMER, timerHandler); timer.start(); function openHandler(event:Event):void { isOpen = true; } function closeHandler(event:Event):void { isOpen = false; } function timerHandler(event:TimerEvent):void { if (isOpen) { myComboBox.close(); } else { myComboBox.open(); } }
getItemAt | () | méthode |
public function getItemAt(index:uint):Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère l’élément à l’index spécifié.
Paramètres
index:uint — Index de l’élément à récupérer.
|
Object — Objet présent à l’index spécifié.
|
Exemple ( Comment utiliser cet exemple )
getItemAt()
pour copier les éléments du ComboBox dans un composant DataGrid :
import fl.controls.ComboBox; import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1", price:0.34}); myComboBox.addItem({label:"Item 2", price:13.19}); myComboBox.addItem({label:"item 3", price:2.96}); myComboBox.addItem({label:"Item 4", price:3.49}); myComboBox.addItem({label:"Item 5", price:1.27}); myComboBox.move(10, 10); addChild(myComboBox); var indexCol:DataGridColumn = new DataGridColumn("index"); indexCol.headerText = ""; indexCol.sortOptions = Array.NUMERIC; var labelCol:DataGridColumn = new DataGridColumn("label"); labelCol.sortOptions = Array.CASEINSENSITIVE; var priceCol:DataGridColumn = new DataGridColumn("price"); priceCol.sortOptions = Array.NUMERIC; var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(indexCol); myDataGrid.addColumn(labelCol); myDataGrid.addColumn(priceCol); myDataGrid.move(10, 40); myDataGrid.rowCount = myComboBox.length; myDataGrid.width = 180; addChild(myDataGrid); var i:uint; var item:Object; for (i = 0; i < myComboBox.length; i++) { item = myComboBox.getItemAt(i); myDataGrid.addItem({index:i, label:item.label, price:item.price}); }
getStyleDefinition | () | méthode |
public static function getStyleDefinition():Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère la texture de style par défaut du composant actif. La texture de style contient le type adapté au composant, qui dépend du style utilisé par ce dernier. Par exemple, le style disabledTextFormat
contient la valeur null
ou un objet TextFormat. Vous pouvez utiliser ces styles et appeler setStyle()
pour le composant actif. Le code suivant ignore le style par défaut disabledTextFormat
dans le composant spécifié :
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Objet de styles par défaut.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import fl.controls.*; import fl.containers.*; import fl.controls.listClasses.*; import fl.controls.dataGridClasses.*; import fl.controls.progressBarClasses.*; import fl.core.UIComponent; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } ); dp.addItem( { label: "Button", data:Button } ); dp.addItem( { label: "CellRenderer", data:CellRenderer } ); dp.addItem( { label: "CheckBox", data:CheckBox } ); dp.addItem( { label: "ColorPicker", data:ColorPicker } ); dp.addItem( { label: "ComboBox", data:ComboBox } ); dp.addItem( { label: "DataGrid", data:DataGrid } ); dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } ); dp.addItem( { label: "ImageCell", data:ImageCell } ); dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } ); dp.addItem( { label: "Label", data:Label } ); dp.addItem( { label: "List", data:List } ); dp.addItem( { label: "NumericStepper", data:NumericStepper } ); dp.addItem( { label: "ProgressBar", data:ProgressBar } ); dp.addItem( { label: "RadioButton", data:RadioButton } ); dp.addItem( { label: "ScrollPane", data:ScrollPane } ); dp.addItem( { label: "Slider", data:Slider } ); dp.addItem( { label: "TextArea", data:TextArea } ); dp.addItem( { label: "TextInput", data:TextInput } ); dp.addItem( { label: "TileList", data:TileList } ); dp.addItem( { label: "UILoader", data:UILoader } ); dp.addItem( { label: "UIComponent", data:UIComponent } ); var cb:ComboBox = new ComboBox(); cb.move(10,10); cb.setSize(300,25); cb.prompt = "Select a component to view its styles"; cb.rowCount = 12; cb.dataProvider = dp; cb.addEventListener(Event.CHANGE, showStyleDefinition); addChild(cb); var dg:DataGrid = new DataGrid(); dg.setSize(425,300); dg.move(10,50); dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ]; addChild(dg); function showStyleDefinition(e:Event):void { var componentClass:Class = e.target.selectedItem.data as Class; var styles:Object = componentClass["getStyleDefinition"].call(this); trace(styles.toString()); var styleData:DataProvider = new DataProvider(); for(var i:* in styles) { trace(i + " : " + styles[i]); styleData.addItem( { StyleName:i, DefaultValue:styles[i] } ); } styleData.sortOn("StyleName"); dg.dataProvider = styleData; }
itemToLabel | () | méthode |
public function itemToLabel(item:Object):String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Extrait la chaîne normalement affichée par l’objet de rendu pour l’objet de données fourni en fonction des propriétés labelField
et labelFunction
.
Remarque : labelField
n’est pas utilisé lorsque la propriété labelFunction
est définie sur une fonction de rappel.
Paramètres
item:Object — Objet à restituer.
|
String — Chaîne à afficher en fonction des données.
|
Eléments de l’API associés
open | () | méthode |
public function open():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Ouvre la liste déroulante.
Remarque : l’appel de cette méthode déclenche la diffusion de l’événement open
. Lorsque le composant ComboBox est déjà ouvert, l’appel de cette méthode n’a aucun effet.
Eléments de l’API associés
removeAll | () | méthode |
public function removeAll():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Supprime tous les éléments de la liste.
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
removeAll()
:
import fl.controls.Button; import fl.controls.ComboBox; import fl.controls.TextInput; var greenTF:TextFormat; var redTF:TextFormat; var myTextInput:TextInput; var addButton:Button; var myComboBox:ComboBox; var removeButton:Button; greenTF = new TextFormat(); greenTF.color = 0x006600; redTF = new TextFormat(); redTF.color = 0xFF0000; myTextInput = new TextInput(); myTextInput.maxChars = 20; myTextInput.restrict = "a-zA-Z"; myTextInput.move(10, 10); addChild(myTextInput); addButton = new Button(); addButton.label = "(+) Add"; addButton.setStyle("textFormat", greenTF); addButton.move(120, 10); addButton.addEventListener(MouseEvent.CLICK, addClickHandler); addChild(addButton); myComboBox = new ComboBox(); myComboBox.move(10, 40); addChild(myComboBox); removeButton = new Button(); removeButton.label = "(-) Remove All"; removeButton.setStyle("textFormat", redTF); removeButton.move(120, 40); removeButton.addEventListener(MouseEvent.CLICK, removeClickHandler); addChild(removeButton); function addClickHandler(event:MouseEvent):void { if (myTextInput.length > 0) { trace("adding item..."); myComboBox.addItem({label:myTextInput.text}); myComboBox.sortItemsOn("label", Array.CASEINSENSITIVE); myTextInput.text = ""; } } function removeClickHandler(event:MouseEvent):void { trace("removing all items..."); myComboBox.removeAll(); }
removeItem | () | méthode |
public function removeItem(item:Object):Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Supprime l’élément spécifié de la liste.
Paramètres
item:Object — Elément à supprimer.
|
Object — Elément qui a été supprimé.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import fl.controls.List; import fl.events.ListEvent; var myList:List = new List(); myList.addItem( { label: "Carrot" } ); myList.addItem( { label: "Turnip" } ); myList.addItem( { label: "Tomato" } ); myList.addItem( { label: "Blueberry" } ); myList.addEventListener(ListEvent.ITEM_CLICK,removeSelectedItem); addChild(myList); function removeSelectedItem(e:ListEvent):void { myList.removeItem(e.item); }
removeItemAt | () | méthode |
public function removeItemAt(index:uint):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Supprime l’élément présent à l’emplacement d’index spécifié. Les index d’emplacement des éléments dont les index sont supérieurs à la progression d’index spécifiée dans le tableau 1.
Il s’agit d’une méthode du composant List qui est disponible à partir d’une occurrence de composant ComboBox.
Paramètres
index:uint — Index de l’élément à supprimer.
|
Valeur émise
RangeError — L’index spécifié est inférieur à 0 ou supérieur ou égal à la longueur du fournisseur de données.
|
Eléments de l’API associés
replaceItemAt | () | méthode |
public function replaceItemAt(item:Object, index:uint):Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Remplace l’élément, à l’index spécifié, par un autre élément. Cette méthode modifie le fournisseur de données du composant List. Lorsque le fournisseur de données est partagé avec d’autres composants, les données qui sont fournies à ces composants sont également mises à jour.
Paramètres
item:Object — Elément devant remplacer l’élément à l’emplacement d’index spécifié.
| |
index:uint — Indice de l’élément à remplacer.
|
Object — Elément qui a été remplacé.
|
Exemple ( Comment utiliser cet exemple )
replaceItemAt()
:
import fl.controls.Button; import fl.controls.ComboBox; import fl.controls.TextArea; import fl.controls.TextInput; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user..."; myComboBox.addItem({label:"Person 1"}); myComboBox.addItem({label:"Person 2"}); myComboBox.addItem({label:"Person 3"}); myComboBox.addItem({label:"Person 4"}); myComboBox.width = 150; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var myTextInput:TextInput = new TextInput(); myTextInput.restrict = "a-zA-Z0-9"; myTextInput.maxChars = 12; myTextInput.move(10, 40); addChild(myTextInput) var myButton:Button = new Button(); myButton.label = "Replace item"; myButton.addEventListener(MouseEvent.CLICK, clickHandler); myButton.move(120, 40); addChild(myButton); var myTextArea:TextArea = new TextArea(); myTextArea.editable = false; myTextArea.setSize(320, 240); myTextArea.move(10, 70); addChild(myTextArea); function changeHandler(event:Event):void { myTextInput.text = myComboBox.selectedLabel; } function clickHandler(event:MouseEvent):void { var cIndex:int = myComboBox.selectedIndex; if (cIndex > -1) { var newItem:Object = {label:myTextInput.text}; var oldItem:Object = myComboBox.replaceItemAt(newItem, cIndex); myComboBox.selectedIndex = cIndex; myTextArea.appendText("[index:" + cIndex + "] old:'" + oldItem.label +"', new:'" + newItem.label + "'\n"); myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition; } }
sortItems | () | méthode |
public function sortItems(... sortArgs):*
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Trie les éléments du fournisseur de données actuel. Cette méthode effectue un tri en fonction des valeurs Unicode des éléments. ASCII est un sous-ensemble de Unicode.
Paramètres
... sortArgs — Les arguments à appliquer pour le tri.
|
* — La valeur renvoyée varie en fonction des paramètres qui sont transmis à cette méthode. Pour plus d’informations, consultez la méthode Array.sort() . Cette méthode renvoie 0 lorsque le paramètre sortArgs est défini sur Array.UNIQUESORT .
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
upperCaseSort()
, qui compare les propriétés label
de deux éléments et renvoie une valeur booléenne fonction de l’ordre dans lequel l’élément doit s’afficher :
import fl.controls.ComboBox; var cb:ComboBox = new ComboBox(); cb.addItem( { label: "Mercury" } ); cb.addItem( { label: "Venus" } ); cb.addItem( { label: "Earth" } ); cb.addItem( { label: "planet" } ); cb.sortItems(upperCaseSort); addChild(cb); function upperCaseSort(a:Object, b:Object):Boolean { return a.label.toUpperCase() > b.label.toUpperCase(); }
sortItemsOn | () | méthode |
public function sortItemsOn(field:String, options:Object = null):*
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Trie les éléments du fournisseur de données actuel en fonction d’un ou plusieurs de ses champs.
Paramètres
field:String — Les champs sur lesquels porte le tri.
| |
options:Object (default = null ) — Arguments de tri destinés à remplacer le comportement de tri par défaut. Sépare deux ou plusieurs arguments avec l’opérateur OR (|) au niveau du bit.
|
* — La valeur renvoyée varie en fonction des paramètres qui sont transmis à cette méthode. Pour plus d’informations, voir la méthode Array.sortOn() . Cette méthode renvoie 0 lorsque le paramètre sortOption est défini sur Array.UNIQUESORT .
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
cb
contenant quatre éléments appelés "Apples"
, "Bananas"
, "cherries"
et "Grapes"
:
import fl.controls.ComboBox; var cb:ComboBox = new ComboBox(); addChild(cb); // First, populate the ComboBox with the elements. cb.addItem( { label: "Bananas" } ); cb.addItem( { label: "Apples" } ); cb.addItem( { label: "cherries" } ); cb.addItem( { label: "Grapes" } ); // The following statement sorts using the order parameter set to "ASC", // and results in a sort that places "cherries" at the bottom of the list // because the sort is case-sensitive. cb.sortItemsOn("label", "ASC"); // resulting order: Apples, Bananas, Grapes, cherries // The following statement sorts using the order parameter set to "DESC", // and results in a sort that places "cherries" at the top of the list // because the sort is case-sensitive. cb.sortItemsOn("label", "DESC"); // resulting order: cherries, Grapes, Bananas, Apples // The following statement sorts using the optionsFlag parameter set to // Array.CASEINSENSITIVE. Note that an ascending sort is the default setting. cb.sortItemsOn("label", Array.CASEINSENSITIVE); // resulting order: Apples, Bananas, cherries, Grapes // The following statement sorts using the optionsFlag parameter set to // Array.CASEINSENSITIVE | Array.DESCENDING. cb.sortItemsOn("label", Array.CASEINSENSITIVE | Array.DESCENDING); // resulting order: Grapes, cherries, Bananas, Apples
sortItemsOn()
:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.sortItemsOn("lastName", Array.CASEINSENSITIVE); myComboBox.labelFunction = nameLabelFunction; myComboBox.move(10, 10); addChild(myComboBox); function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
change | Evénement |
flash.events.Event
propriété Event.type =
flash.events.Event.CHANGE
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Distribué lorsque l’utilisateur change la sélection dans le composant ComboBox ou, si ce dernier est modifiable, à chaque saisie d’une combinaison de touches par l’utilisateur dans le champ de texte.
Remarque : même si le tableau ci-dessous indique que l’événement change
se propage, il ne se propage pas pour le contrôle fl.controls.ComboBox.
Event.CHANGE
définit la valeur de la propriété type
de l’objet d’événement change
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet dont la valeur a été modifiée. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement. |
close | Evénement |
flash.events.Event
propriété Event.type =
flash.events.Event.CLOSE
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Distribué lorsque la liste déroulante se ferme pour une raison quelconque.
La constanteEvent.CLOSE
définit la valeur de la propriété type
d’un objet événement close
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet dont la connexion a été fermée. |
Exemple ( Comment utiliser cet exemple )
open()
et close()
:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(Event.OPEN, openHandler); myComboBox.addEventListener(Event.CLOSE, closeHandler); addChild(myComboBox); var isOpen:Boolean = false; var timer:Timer = new Timer(1000); timer.addEventListener(TimerEvent.TIMER, timerHandler); timer.start(); function openHandler(event:Event):void { isOpen = true; } function closeHandler(event:Event):void { isOpen = false; } function timerHandler(event:TimerEvent):void { if (isOpen) { myComboBox.close(); } else { myComboBox.open(); } }
Eléments de l’API associés
enter | Evénement |
fl.events.ComponentEvent
propriété ComponentEvent.type =
fl.events.ComponentEvent.ENTER
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Distribué si la propriété editable
est définie sur true
et que l’utilisateur appuie sur la touche Entrée pendant qu’il tape du texte dans un champ de texte modifiable.
type
d’un objet de l’événement enter
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
itemRollOut | Evénement |
fl.events.ListEvent
propriété ListEvent.type =
fl.events.ListEvent.ITEM_ROLL_OUT
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Distribué lorsque le pointeur de la souris cesse de survoler un élément du composant.
Définit la valeur de la propriété
type
d’un objet de l’événement itemRollOut
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
columnIndex | Index de base zéro de la colonne qui contient la fonctionnalité de rendu. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
index | Index de base zéro du DataProvider qui contient la fonction de rendu. |
item | Référence à la donnée qui appartient à la fonction de rendu. |
rowIndex | Index de base zéro de la ligne qui contient la fonction de rendu. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
Eléments de l’API associés
itemRollOver | Evénement |
fl.events.ListEvent
propriété ListEvent.type =
fl.events.ListEvent.ITEM_ROLL_OVER
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Distribué lorsque le pointeur de la souris survole un élément du composant.
Définit la valeur de la propriété
type
d’un objet de l’événement itemRollOver
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
columnIndex | Index de base zéro de la colonne qui contient la fonctionnalité de rendu. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
index | Index de base zéro du DataProvider qui contient la fonction de rendu. |
item | Référence à la donnée qui appartient à la fonction de rendu. |
rowIndex | Index de base zéro de la ligne qui contient la fonction de rendu. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
Exemple ( Comment utiliser cet exemple )
import fl.controls.ComboBox; import fl.controls.TextArea; import fl.events.ListEvent; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(Event.OPEN, openHandler); myComboBox.addEventListener(Event.CLOSE, closeHandler); myComboBox.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler); myComboBox.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOutHandler); myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler); myComboBox.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler); myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, dropdownRollOverHandler) myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, dropdownRollOutHandler); addChild(myComboBox); var myTextArea:TextArea = new TextArea(); myTextArea.editable = false; myTextArea.setSize(320, 240); myTextArea.move(120, 10); addChild(myTextArea); function openHandler(event:Event):void { logEvent("ComboBox open"); } function closeHandler(event:Event):void { logEvent("ComboBox close"); } function itemRollOverHandler(event:ListEvent):void { var rowIdx:uint = event.rowIndex as uint; logEvent("ComboBox itemRollOver: " + "`" + myComboBox.getItemAt(rowIdx).label + "`"); } function itemRollOutHandler(event:ListEvent):void { var rowIdx:uint = event.rowIndex as uint; logEvent("ComboBox itemRollOut: " + "`" + myComboBox.getItemAt(rowIdx).label + "`"); } function rollOverHandler(event:MouseEvent):void { logEvent("ComboBox rollOver"); myComboBox.open(); } function rollOutHandler(event:MouseEvent):void { logEvent("ComboBox rollOut"); myComboBox.close(); } function dropdownRollOverHandler(event:MouseEvent):void { logEvent("ComboBox.dropdown rollOver"); // reopen ComboBox after it gets closed by the ComboBox rollOut event myComboBox.open(); } function dropdownRollOutHandler(event:MouseEvent):void { logEvent("ComboBox.dropdown rollOut"); myComboBox.close(); } function logEvent(text:String):void { myTextArea.appendText(text + "\n"); myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition; }
Eléments de l’API associés
open | Evénement |
flash.events.Event
propriété Event.type =
flash.events.Event.OPEN
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Distribué lorsque l’utilisateur clique sur un bouton déroulant pour afficher la liste déroutante. Egalement distribué lorsque l’utilisateur clique sur le champ de texte, si le composant ComboBox n’est pas modifiable.
La constanteEvent.OPEN
définit la valeur de la propriété type
d’un objet événement open
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet réseau qui a ouvert une connexion. |
Exemple ( Comment utiliser cet exemple )
open()
. Le menu déroulant se referme 1 seconde plus tard, sauf si l’utilisateur déplace sa souris sur le ComboBox ou son menu déroulant :
import fl.controls.Button; import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler); myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler); myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler); addChild(myComboBox); var myButton:Button = new Button(); myButton.emphasized = true; myButton.label = "open ComboBox"; myButton.move(120, 10); myButton.addEventListener(MouseEvent.CLICK, clickHandler); addChild(myButton); var closeTimer:Timer = new Timer(1000, 1); closeTimer.addEventListener(TimerEvent.TIMER_COMPLETE, timerCompleteHandler); function clickHandler(event:MouseEvent):void { myComboBox.open(); closeTimer.reset(); closeTimer.start(); } function timerCompleteHandler(event:TimerEvent):void { myComboBox.close(); } function rollOverHandler(event:MouseEvent):void { closeTimer.stop(); } function rollOutHandler(event:MouseEvent):void { myComboBox.close(); }
Eléments de l’API associés
scroll | Evénement |
fl.events.ScrollEvent
propriété ScrollEvent.type =
fl.events.ScrollEvent.SCROLL
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS3 |
Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Distribué lorsque l’utilisateur parcourt la liste déroulante du composant ComboBox.
Définit la valeur de la propriététype
d’un objet d’événement scroll
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
delta | 1 ; valeur indiquant la longueur du défilement effectué.
|
direction | vertical ; direction de l’objet ScrollBar. |
position | 0 ; position du curseur de Scrollbar après son déplacement. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
- Faites glisser un composant ComboBox sur la scène et appelez-le
cb
. - Enregistrez ce code sous le nom ComboBoxExample.as dans le même répertoire que votre fichier FLA.
- Dans le fichier FLA, définissez DocumentClass sur ComboBoxExample.
package { import flash.display.Sprite import flash.text.TextField; import flash.events.Event; import fl.controls.ComboBox; public class ComboBoxExample extends Sprite { private var tf:TextField; public function ComboBoxExample() { setupComboBox(); setupTextField(); } private function setupTextField():void { tf = new TextField(); tf.x = 180; tf.y = 15; tf.autoSize = "left"; addChild(tf); } private function setupComboBox():void { cb.setSize(150,22); cb.addItem( { label: "MasterCard", data:1 } ); cb.addItem( { label: "Visa", data:2 } ); cb.addItem( { label: "American Express", data:3 } ); cb.addEventListener(Event.CHANGE, cardSelected); } private function cardSelected(e:Event):void { tf.text = "You have selected: " tf.appendText(cb.selectedItem.label); } } }
Tue Jun 12 2018, 09:30 AM Z