SelectableList

Package	fl.controls
Classe	public class SelectableList
Héritage	SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
Implémente	IFocusManagerComponent
Sous-classes	DataGrid, List, TileList

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

La classe SelectableList est la classe de base pour tous les composants à base de listes (par exemple, List, TileList, DataGrid et ComboBox). Cette classe fournit des méthodes et des propriétés qui sont utilisées pour le rendu et la mise en forme de lignes et pour définir les styles de barre de défilement et les fournisseurs de données.

Remarque : cette classe ne crée pas de composant ; elle n’est exposée que si elle peut être étendue.

Eléments de l’API associés

fl.controls.DataGrid
fl.controls.List
fl.controls.TileList
fl.data.DataProvider

Propriétés publiques

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

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

	Propriété		Défini par
		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
		allowMultipleSelection : Boolean Lit une valeur booléenne qui indique si plusieurs éléments de la liste peuvent être sélectionnés en même temps.	SelectableList
		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.	SelectableList
		doubleClickEnabled : Boolean Spécifie si l’objet reçoit les événements doubleClick.	InteractiveObject
		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
		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
		horizontalLineScrollSize : Number Récupère ou définit une valeur décrivant la quantité de contenu à faire défiler horizontalement lorsque l’utilisateur clique sur un bouton fléché.	BaseScrollPane
		horizontalPageScrollSize : Number Récupère ou définit le nombre de pixels selon lequel le curseur de la barre de défilement horizontal se déplace lorsque l’utilisateur clique sur le rail de la barre de défilement.	BaseScrollPane
		horizontalScrollBar : ScrollBar [lecture seule] Lit une référence à la barre de défilement horizontale.	BaseScrollPane
		horizontalScrollPolicy : String Récupère ou définit une valeur indiquant l’état de la barre de défilement horizontale.	BaseScrollPane
		horizontalScrollPosition : Number Récupère ou définit une valeur décrivant la position horizontale de la barre de défilement horizontale dans le panneau défilant, en pixels.	BaseScrollPane
		length : uint [lecture seule] Lit le nombre d’éléments présents dans le fournisseur de données.	SelectableList
		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
		maxHorizontalScrollPosition : Number [override] Lit ou définit le nombre de pixels jusqu’où la liste peut défiler vers la droite, lorsque la propriété horizontalScrollPolicy est définie sur ScrollPolicy.ON.	SelectableList
		maxVerticalScrollPosition : Number [lecture seule] Obtient la position de défilement vertical maximale pour le contenu actif, en pixels.	BaseScrollPane
		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
		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 [lecture seule] Lit le nombre de lignes au moins partiellement visibles dans la liste.	SelectableList
		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
		selectable : Boolean Lit ou définit une valeur booléenne qui indique si les éléments de la liste peuvent être sélectionnés.	SelectableList
		selectedIndex : int Lit ou définit l’index de l’élément qui est sélectionné dans une liste à sélection unique.	SelectableList
		selectedIndices : Array Lit ou définit un tableau qui contient les articles qui ont été sélectionnés à partir d’une liste à sélections multiples.	SelectableList
		selectedItem : Object Lit ou définit l’élément qui a été sélectionné à partir d’une liste à sélection unique.	SelectableList
		selectedItems : Array Lit ou définit un tableau qui contient les objets qui ont été sélectionnés à partir d’une liste à sélections multiples.	SelectableList
		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
		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
		useBitmapScrolling : Boolean Si définie sur true, la valeur de la propriété cacheAsBitmap du contenu de défilement est true ; si définie sur false, cette valeur est désactivée.	BaseScrollPane
		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
		verticalLineScrollSize : Number Récupère ou définit une valeur décrivant la quantité de pixels à faire défiler verticalement lorsque l’utilisateur clique sur un bouton fléché.	BaseScrollPane
		verticalPageScrollSize : Number Récupère ou définit le nombre de pixels selon lequel le curseur de la barre de défilement vertical se déplace lorsque l’utilisateur clique sur le rail de la barre de défilement.	BaseScrollPane
		verticalScrollBar : ScrollBar [lecture seule] Récupère une référence à la barre de défilement vertical.	BaseScrollPane
		verticalScrollPolicy : String Récupère ou définit une valeur indiquant l’état de la barre de défilement verticale.	BaseScrollPane
		verticalScrollPosition : Number Récupère ou définit une valeur décrivant la position verticale de la barre de défilement verticale dans le panneau défilant, en pixels.	BaseScrollPane
		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éthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		SelectableList() Crée une nouvelle occurrence du composant SelectableList.	SelectableList
		addChild(child:DisplayObject):DisplayObject Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 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
		addItem(item:Object):void Ajoute un élément à la fin de la liste d’éléments.	SelectableList
		addItemAt(item:Object, index:uint):void Insère un élément dans la liste, à l’index spécifié.	SelectableList
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 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
		clearRendererStyle(name:String, column:int = -1):void Supprime un style qui est défini sur les fonctionnalités de rendu de la liste.	SelectableList
		clearSelection():void Efface l’élément actuellement sélectionné dans la liste et définit la propriété selectedIndex sur -1.	SelectableList
		clearStyle(style:String):void Définit une propriété de style depuis cette occurrence de composant.	UIComponent
		contains(child:DisplayObject):Boolean 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
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		drawFocus(focused:Boolean):void Affiche ou masque l’indicateur de focus dans ce composant.	UIComponent
		drawNow():void Déclenche une opération de dessin immédiate, sans tout annuler comme le fait invalidateNow.	UIComponent
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 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
		getChildAt(index:int):DisplayObject Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Renvoie l’objet d’affichage enfant portant le nom spécifié.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Renvoie la position d’index d’une occurrence enfant de DisplayObject.	DisplayObjectContainer
		getFocus():InteractiveObject Récupère l’objet qui détient actuellement le focus.	UIComponent
		getItemAt(index:uint):Object Récupère l’élément à l’index spécifié.	SelectableList
		getNextIndexAtLetter(firstLetter:String, startIndex:int = -1):int Renvoie l’index du prochain élément du dataProvider dans lequel le premier caractère de l’étiquette correspond à un caractère de chaîne spécifié.	SelectableList
		getObjectsUnderPoint(point:Point):Array 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
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 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
		getRendererStyle(name:String, column:int = -1):Object Récupère un style qui est défini sur les fonctionnalités de rendu de la liste.	SelectableList
		getStyle(style:String):Object Extrait une propriété de style définie dans la chaîne de recherche de style du composant.	UIComponent
		getStyleDefinition():Object [statique] Récupère la texture de style par défaut du composant actif.	SelectableList
		globalToLocal(point:Point):Point Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales).	DisplayObject
		globalToLocal3D(point:Point):Vector3D Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales).	DisplayObject
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		hitTestObject(obj:DisplayObject):Boolean 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
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y.	DisplayObject
		invalidate(property:String, callLater:Boolean = true):void Marque une propriété comme non valide, puis redessine le composant dans la prochaine image, sauf spécification contraire.	UIComponent
		invalidateItem(item:Object):void Invalide un rendu d’élément spécifique.	SelectableList
		invalidateItemAt(index:uint):void Invalide le rendu de l’élément présent à l’index spécifié.	SelectableList
		invalidateList():void Invalide l’ensemble de la liste et impose un nouveau dessin de tous les éléments.	SelectableList
		isItemSelected(item:Object):Boolean Vérifie si l’élément spécifié est sélectionné dans la liste.	SelectableList
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		itemToCellRenderer(item:Object):ICellRenderer Renvoie ICellRenderer pour un objet d’élément donné, le cas échéant.	SelectableList
		itemToLabel(item:Object):String Extrait la chaîne affichée par l’objet de rendu pour l’objet de données fourni en fonction des propriétés label de l’objet.	SelectableList
		local3DToGlobal(point3d:Vector3D):Point 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
		localToGlobal(point:Point):Point Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales).	DisplayObject
		mergeStyles(... list):Object [statique] Fusionne les styles de plusieurs classes en un seul objet.	UIComponent
		move(x:Number, y:Number):void Déplace le composant à la position spécifiée dans son parent.	UIComponent
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeAll():void Supprime tous les éléments de la liste.	SelectableList
		removeChild(child:DisplayObject):DisplayObject Supprime l’occurrence enfant de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer.	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void Supprime toutes les occurrences enfants de DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		removeItem(item:Object):Object Supprime l’élément spécifié de la liste.	SelectableList
		removeItemAt(index:uint):Object Supprime l’élément présent à l’emplacement d’index spécifié.	SelectableList
		replaceItemAt(item:Object, index:uint):Object Remplace l’élément, à l’index spécifié, par un autre élément.	SelectableList
		requestSoftKeyboard():Boolean Affiche un clavier virtuel.	InteractiveObject
		scrollToIndex(newCaretIndex:int):void Fait défiler la liste jusqu’à l’élément, à l’index spécifié.	SelectableList
		scrollToSelected():void Fait défiler la liste jusqu’à l’élément, à l’emplacement indiqué par la valeur actuelle de la propriété selectedIndex.	SelectableList
		setChildIndex(child:DisplayObject, index:int):void Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage.	DisplayObjectContainer
		setFocus():void Définit le focus sur ce composant.	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		setRendererStyle(name:String, style:Object, column:uint = 0):void Définit un style pour les fonctionnalités de rendu dans la liste.	SelectableList
		setSize(width:Number, height:Number):void Définit le composant en fonction de la largeur et de la hauteur spécifiées.	UIComponent
		setStyle(style:String, value:Object):void Définit une propriété de style pour cette occurrence de composant.	UIComponent
		sortItems(... sortArgs):* Trie les éléments du fournisseur de données actuel.	SelectableList
		sortItemsOn(field:String, options:Object = null):* Trie les éléments du fournisseur de données actuel en fonction d’un ou plusieurs de ses champs.	SelectableList
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Permet à l’utilisateur de faire glisser le sprite spécifié.	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void Permet à l’utilisateur de faire glisser le sprite spécifié sur un périphérique tactile.	Sprite
		stopAllMovieClips():void Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine.	DisplayObjectContainer
		stopDrag():void Met fin à la méthode startDrag().	Sprite
		stopTouchDrag(touchPointID:int):void Met fin à la méthode startTouchDrag() en vue d’utiliser des périphériques tactiles.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés.	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 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
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		validateNow():void Valide et met à jour les propriétés et la mise en forme de cet objet, puis le redessine si nécessaire.	UIComponent
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean 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

Méthodes protégées

Masquer les méthodes protégées héritées

Afficher les méthodes protégées héritées

	Méthode		Défini par
		getStyleValue(name:String):Object Renvoie le style spécifié pour un composant, en tenant compte de tous les styles définis au niveau global, au niveau du composant et au niveau de l’occurrence.	UIComponent

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
added	Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage.	DisplayObject
addedToStage	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
change	Distribué lorsqu’un autre élément est sélectionné dans la liste.	SelectableList
clear	Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel.	InteractiveObject
click	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
contextMenu	Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR.	InteractiveObject
copy	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
cut	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
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
doubleClick	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
enterFrame	[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image.	DisplayObject
exitFrame	[événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours.	DisplayObject
focusIn	Distribué après la prise de focus par un objet d’affichage.	InteractiveObject
focusOut	Distribué après la perte de focus par un objet d’affichage.	InteractiveObject
frameConstructed	[é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
gestureDirectionalTap	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
gestureLongPress	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
gesturePan	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
gestureRotate	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
gestureSwipe	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
gestureTap	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
gestureZoom	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
hide	Distribué après que la visibilité du composant soit passée de visible à invisible.	UIComponent
imeStartComposition	Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME.	InteractiveObject
itemClick	Distribué lorsque l’utilisateur clique sur un élément du composant.	SelectableList
itemDoubleClick	Distribué lorsque l’utilisateur clique rapidement à deux reprises sur un élément du composant.	SelectableList
itemRollOut	Distribué lorsque le pointeur de la souris cesse de survoler un élément du composant.	SelectableList
itemRollOver	Distribué lorsque le pointeur de la souris survole un élément du composant.	SelectableList
keyDown	Distribué lorsque l’utilisateur appuie sur une touche.	InteractiveObject
keyFocusChange	Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier.	InteractiveObject
keyUp	Distribué lorsque l’utilisateur relâche une touche.	InteractiveObject
middleClick	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
middleMouseDown	Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject.	InteractiveObject
middleMouseUp	Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.	InteractiveObject
mouseDown	Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.	InteractiveObject
mouseFocusChange	Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage.	InteractiveObject
mouseMove	Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject.	InteractiveObject
mouseOut	Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject.	InteractiveObject
mouseOver	Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.	InteractiveObject
mouseUp	Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.	InteractiveObject
mouseWheel	Distribué lorsque la molette d’une souris est actionnée sur une occurrence de InteractiveObject.	InteractiveObject
move	Distribué à la suite du déplacement du composant.	UIComponent
nativeDragComplete	Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser.	InteractiveObject
nativeDragDrop	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
nativeDragEnter	Distribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites.	InteractiveObject
nativeDragExit	Distribué par un InteractiveObject lorsqu’une opération glisser sort des limites.	InteractiveObject
nativeDragOver	Distribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites.	InteractiveObject
nativeDragStart	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
nativeDragUpdate	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
paste	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
proximityBegin	Distribué lorsque l’utilisateur approche un stylet actif de l’écran après le seuil de détection de proximité de l’écran.	InteractiveObject
proximityEnd	Distribué lorsque l’utilisateur soulève un stylet actif au-dessus du seuil de détection de proximité de l’écran.	InteractiveObject
proximityMove	Distribué lorsque l’utilisateur déplace un stylet actif sur l’écran tout en respectant le seuil de détection de proximité.	InteractiveObject
proximityOut	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
proximityOver	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
proximityRollOut	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
proximityRollOver	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
releaseOutside	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
removed	Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage.	DisplayObject
removedFromStage	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
render	[événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée.	DisplayObject
resize	Distribué à la suite du redimensionnement du composant.	UIComponent
rightClick	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
rightMouseDown	Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.	InteractiveObject
rightMouseUp	Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.	InteractiveObject
rollOut	Distribué lorsque le pointeur de la souris cesse de survoler le composant.	SelectableList
rollOver	Distribué lorsque le pointeur de la souris survole le composant.	SelectableList
scroll	Distribué lorsque l’utilisateur effectue un défilement horizontal ou vertical.	SelectableList
selectAll	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
show	Distribué après que la visibilité du composant soit passée de invisible à visible.	UIComponent
softKeyboardActivate	Distribué immédiatement après l’affichage du clavier logiciel.	InteractiveObject
softKeyboardActivating	Distribué immédiatement avant l’affichage du clavier logiciel.	InteractiveObject
softKeyboardDeactivate	Distribué immédiatement après la disparition du clavier logiciel.	InteractiveObject
tabChildrenChange	Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change.	InteractiveObject
tabEnabledChange	Distribué lorsque l’indicateur tabEnabled de l’objet change.	InteractiveObject
tabIndexChange	Distribué lorsque la valeur de la propriété tabIndex de l’objet change.	InteractiveObject
textInput	Distribué lorsqu’un utilisateur entre un ou plusieurs caractères de texte.	InteractiveObject
touchBegin	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
touchEnd	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
touchMove	Distribué lorsque l’utilisateur appuie sur le périphérique, et est continuellement distribué jusqu’au retrait du point de contact.	InteractiveObject
touchOut	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
touchOver	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
touchRollOut	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
touchRollOver	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
touchTap	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

Styles

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.

Styles communs

Cliquez pour plus d’informations sur les styles

Masquer les styles hérités

Afficher les styles hérités

	Description	Défini par
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.contols.listClasses.CellRenderer`.	SelectableList
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 qui sépare la bordure de la liste et son contenu, en pixels. La valeur par défaut est `null`.	SelectableList
disabledAlpha	Type: Number 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 `null`.	SelectableList
disabledTextFormat	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é.	BaseScrollPane
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.	BaseScrollPane
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.	BaseScrollPane
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.	BaseScrollPane
focusRectPadding	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
focusRectSkin	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
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`.	BaseScrollPane
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`.	BaseScrollPane
skin	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 l’enveloppe de l’arrière-plan du composant. La valeur par défaut est `List_skin`.	SelectableList
textFormat	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
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.	BaseScrollPane
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.	BaseScrollPane
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.	BaseScrollPane
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.	BaseScrollPane
thumbUpSkin	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.	BaseScrollPane
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é.	BaseScrollPane
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.	BaseScrollPane
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.	BaseScrollPane
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.	BaseScrollPane
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é.	BaseScrollPane
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.	BaseScrollPane
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.	BaseScrollPane
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.	BaseScrollPane

Constantes publiques

Masquer les constantes publiques héritées

Afficher les constantes publiques héritées

	Constante		Défini par
		version : String = "3.0.3.1" Numéro de version des composants.	UIComponent

Détails de la propriété

allowMultipleSelection

propriété

allowMultipleSelection: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

Lit une valeur booléenne qui indique si plusieurs éléments de la liste peuvent être sélectionnés en même temps. La valeur true indique que plusieurs sélections peuvent s’effectuer à la fois. La valeur false indique qu’un seul élément peut être sélectionné à la fois.

La valeur par défaut est false.

Implémentation
public function get allowMultipleSelection():Boolean
public function set allowMultipleSelection(value:Boolean):void

Eléments de l’API associés

selectable

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée une nouvelle occurrence du composant List et recherche les propriétés selectedIndices et selectedIndices lorsque les éléments sélectionnés dans la liste changent :


import fl.controls.List;
import fl.data.DataProvider;

var items:XML = <items>
        <item label="Item A" />
        <item label="Item B" />
        <item label="Item C" />
    </items>;

var dp:DataProvider = new DataProvider(items);

var myList:List = new List();
myList.dataProvider = dp;
myList.allowMultipleSelection = true;
myList.move(10, 10);
myList.setSize(320, 240);
myList.addEventListener(Event.CHANGE, changeHandler);
addChild(myList);

function changeHandler(event:Event):void {
    var lst:List = event.currentTarget as List;
    trace("change:");
    trace("\t" + "selectedIndex:", lst.selectedIndex);
    trace("\t" + "selectedIndices:", lst.selectedIndices);
    trace("\t" + "Number selected items:", lst.selectedIndices.length);
}

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.

La valeur par défaut est null.

Implémentation
public function get dataProvider():DataProvider
public function set dataProvider(value:DataProvider):void

length

propriété

length:uint [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 présents dans le fournisseur de données.

Implémentation
public function get length():uint

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée une occurrence du composant List et définit la propriétérowCount sur le nombre d’éléments actuellement dans la liste :


import fl.controls.List;

var myList:List = new List();
myList.addItem({label:"Item A"});
myList.addItem({label:"Item B"});
myList.addItem({label:"Item C"});
myList.addItem({label:"Item D"});
myList.rowCount = myList.length;
myList.move(10, 10);
addChild(myList);

maxHorizontalScrollPosition

propriété

maxHorizontalScrollPosition:Number[override]

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 le nombre de pixels jusqu’où la liste peut défiler vers la droite, lorsque la propriété horizontalScrollPolicy est définie sur ScrollPolicy.ON.

Implémentation
override public function get maxHorizontalScrollPosition():Number
override public function set maxHorizontalScrollPosition(value:Number):void

Eléments de l’API associés

fl.containers.BaseScrollPane.horizontalScrollPosition
fl.containers.BaseScrollPane.maxVerticalScrollPosition

rowCount

propriété

rowCount:uint [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 de lignes au moins partiellement visibles dans la liste.

Remarque : cette propriété doit être remplacée dans toute classe qui étend SelectableList.

La valeur par défaut est 0.

Implémentation
public function get rowCount():uint

Exemple ( Comment utiliser cet exemple )

Cet exemple définit la taille d’une liste et détermine le nombre de lignes potentiellement visibles en recherchant la propriété rowCount :


import fl.data.DataProvider;
import fl.controls.List;

var dp:DataProvider = new DataProvider();
var i:uint;
for(i=0; i<100; i++) {
    dp.addItem( { label: "Item " + i } );
}

var list:List = new List();
list.setSize(100,300);
list.dataProvider = dp;
addChild(list);

trace(list.rowCount); // 15

selectable

propriété

selectable: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

Lit ou définit une valeur booléenne qui indique si les éléments de la liste peuvent être sélectionnés. La valeur true indique que les éléments de la liste peuvent être sélectionnés, tandis que false indique le contraire.

La valeur par défaut est true.

Implémentation
public function get selectable():Boolean
public function set selectable(value:Boolean):void

Eléments de l’API associés

allowMultipleSelection

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

Implémentation
public function get selectedIndex():int
public function set selectedIndex(value:int):void

Eléments de l’API associés

selectedIndices
selectedItem

Exemple ( Comment utiliser cet exemple )

Cet exemple recherche l’étiquette et l’index de ligne de tout élément d’une liste sur lequel l’utilisateur a cliqué :


import fl.controls.List;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
var i:uint;
for (i = 0; i < 5; i++) {
    dp.addItem( { label: "Sample Name"} );
}

var list:List = new List();
list.dataProvider = dp;
list.addEventListener(Event.CHANGE,announceClickedItem)
addChild(list);

function announceClickedItem(e:Event):void {
    trace("You have clicked: " + list.selectedItem.label + " in row " + list.selectedIndex);
}

selectedIndices

propriété

selectedIndices:Array

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 un tableau qui contient les articles qui ont été sélectionnés à partir d’une liste à sélections multiples.

Pour programmer le remplacement de la sélection actuelle, vous pouvez affecter cette propriété de façon explicite. Vous pouvez effacer la sélection actuelle en définissant cette propriété sur un tableau vide ou sur une valeur undefined. Si aucun article n’est sélectionné dans la liste, cette propriété est undefined.

La séquence de valeurs du tableau correspond à l’ordre de sélection des éléments dans la liste à sélection multiple. Par exemple, si vous cliquez sur le deuxième élément de la liste, puis le troisième et enfin le premier, cette propriété contient une liste de valeurs dans la séquence suivante : [1,2,0].

Implémentation
public function get selectedIndices():Array
public function set selectedIndices(value:Array):void

Eléments de l’API associés

allowMultipleSelection
selectedIndex
selectedItems

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 l’élément qui a été sélectionné à partir d’une liste à sélection unique. Pour les listes à sélections multiples où plusieurs éléments sont sélectionnés, cette propriété contient l’élément qui a été sélectionné en dernier.

Si aucune sélection n’est faite, la valeur de cette propriété est null.

Implémentation
public function get selectedItem():Object
public function set selectedItem(value:Object):void

Eléments de l’API associés

selectedIndex
selectedItems

Exemple ( Comment utiliser cet exemple )

Cet exemple recherche l’étiquette et l’index de ligne de tout élément d’une liste sur lequel l’utilisateur a cliqué :


import fl.controls.List;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
var i:uint;
for (i = 0; i < 5; i++) {
    dp.addItem( { label: "Sample Name"} );
}

var list:List = new List();
list.dataProvider = dp;
list.addEventListener(Event.CHANGE,announceClickedItem)
addChild(list);

function announceClickedItem(e:Event):void {
    trace("You have clicked: " + list.selectedItem.label + " in row " + list.selectedIndex);
}

selectedItems

propriété

selectedItems:Array

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 un tableau qui contient les objets qui ont été sélectionnés à partir d’une liste à sélections multiples.

Pour une liste à sélection unique, la valeur de cette propriété est un tableau qui contient l’élément sélectionné. Dans une liste à sélection unique, la propriété allowMultipleSelection est définie sur false.

Implémentation
public function get selectedItems():Array
public function set selectedItems(value:Array):void

Eléments de l’API associés

allowMultipleSelection
selectedIndices
selectedItem

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée des occurrences du composant List et copie les éléments sélectionnés de la liste A vers la liste B :


import fl.controls.List;
import fl.data.DataProvider;

var listA:List = new List();
listA.allowMultipleSelection = true;
listA.addItem({label:"Item A"});
listA.addItem({label:"Item B"});
listA.addItem({label:"Item C"});
listA.addItem({label:"Item D"});
listA.addItem({label:"Item E"});
listA.addItem({label:"Item F"});
listA.addItem({label:"Item G"});
listA.move(10, 10);
listA.addEventListener(Event.CHANGE, changeHandler);
addChild(listA);

var listB:List = new List();
listB.selectable = false;
listB.move(120, 10);
addChild(listB);

function changeHandler(event:Event):void {
    if (listA.selectedItems.length > 0) {
        listB.dataProvider = new DataProvider(listA.selectedItems);
    }
}

Détails du constructeur

()

Constructeur

public function SelectableList()

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

Détails de la méthode

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()

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.

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

addItem()
replaceItemAt()

clearRendererStyle

()

méthode

public function clearRendererStyle(name:String, column:int = -1):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 un style qui est défini sur les fonctionnalités de rendu de la liste.

Paramètres

	`name:String` — Nom du style à supprimer.

	`column:int` (default = `-1`)

Eléments de l’API associés

getRendererStyle()
setRendererStyle()

clearSelection

()

méthode

public function clearSelection():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

Efface l’élément actuellement sélectionné dans la liste et définit la propriété selectedIndex sur -1.

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée une occurrence du composant List et efface les éléments de liste actuellement sélectionnés lorsque l’utilisateur clique sur un composant Button :


import fl.controls.Button;
import fl.controls.List;
import fl.data.DataProvider;

var data:XML = <items>
        <item label="Person A" id="p001" />
        <item label="Person B" id="p002" />
        <item label="Person C" id="p003" />
    </items>;

var dp:DataProvider = new DataProvider(data);

var myList:List = new List();
myList.allowMultipleSelection = false;
myList.dataProvider = dp;
myList.move(10, 10);
myList.selectedIndex = 0;
addChild(myList);

var clearButton:Button = new Button();
clearButton.label = "Clear selection";
clearButton.move(120, 10);
clearButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(clearButton);

function clickHandler(event:MouseEvent):void {
    trace("selectedIndex (before):", myList.selectedIndex);
    myList.clearSelection();
    trace("selectedIndex (after):", myList.selectedIndex);
}

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.

Valeur renvoyée

Object — Objet présent à l’index spécifié.

Valeur émise

RangeError — L’index spécifié est inférieur à 0 ou supérieur ou égal à la longueur du fournisseur de données.

getNextIndexAtLetter

()

méthode

public function getNextIndexAtLetter(firstLetter:String, startIndex:int = -1):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

Renvoie l’index du prochain élément du dataProvider dans lequel le premier caractère de l’étiquette correspond à un caractère de chaîne spécifié. Si la recherche atteint la fin du dataProvider sans rechercher tous les éléments, elle repartira du début. La recherche n’inclut pas le startIndex.

Paramètres

	`firstLetter:String` — Caractère de chaîne à rechercher

	`startIndex:int` (default = `-1`) — Index où commencer dans le dataProvider.

Valeur renvoyée

int — Index du prochain élément du dataProvider.

getRendererStyle

()

méthode

public function getRendererStyle(name:String, column:int = -1):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 un style qui est défini sur les fonctionnalités de rendu de la liste.

Paramètres

	`name:String` — Nom du style à récupérer.

	`column:int` (default = `-1`) — La valeur du style à récupérer.

Valeur renvoyée

Object

Eléments de l’API associés

clearRendererStyle()
setRendererStyle()

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());

Valeur renvoyée

Object — Objet de styles par défaut.

Eléments de l’API associés

fl.core.UIComponent.getStyle()
fl.core.UIComponent.setStyle()
fl.managers.StyleManager

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée un navigateur de styles pour différentes classes de composant :

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;
}

invalidateItem

()

méthode

public function invalidateItem(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

Invalide un rendu d’élément spécifique.

Paramètres

item:Object — Elément figurant dans le fournisseur de données qui doit être invalidé.

Eléments de l’API associés

invalidateItemAt()
invalidateList()

invalidateItemAt

()

méthode

public function invalidateItemAt(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

Invalide le rendu de l’élément présent à l’index spécifié.

Paramètres

index:uint — Index de l’élément figurant dans le fournisseur de données et à invalider.

Eléments de l’API associés

invalidateItem()
invalidateList()

invalidateList

()

méthode

public function invalidateList():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

Invalide l’ensemble de la liste et impose un nouveau dessin de tous les éléments.

Eléments de l’API associés

invalidateItem()
invalidateItemAt()

isItemSelected

()

méthode

public function isItemSelected(item:Object):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

Vérifie si l’élément spécifié est sélectionné dans la liste.

Paramètres

item:Object — L’élément à vérifier.

Valeur renvoyée

Boolean — Cette méthode renvoie true lorsque l’élément spécifié est sélectionné. Par contre, lorsque l’élément a la valeur null ou s’il n’est pas inclus dans la liste, elle renvoie false.

itemToCellRenderer

()

méthode

public function itemToCellRenderer(item:Object):ICellRenderer

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

Renvoie ICellRenderer pour un objet d’élément donné, le cas échéant. Cette méthode renvoie toujours null.

Paramètres

item:Object — Elément dans le fournisseur de données.

Valeur renvoyée

ICellRenderer — La valeur null.

Exemple ( Comment utiliser cet exemple )

L’exemple suivant démontre comment acquérir le rendu de cellule pour tout élément sélectionné dans une liste :

import fl.controls.List;
import fl.controls.listClasses.ListData;
import fl.controls.listClasses.CellRenderer;
import fl.events.ListEvent;

var sampleItem1:Object = { label:"John Alpha" };
var sampleItem2:Object = { label:"Mary Bravo" };
var sampleItem3:Object = { label:"Trevor Gamma" };
var sampleItem4:Object = { label:"Susan Delta" };        

var myList:List;
myList = new List();
myList.move(10,10);
myList.addItem(sampleItem1);
myList.addItem(sampleItem2);
myList.addItem(sampleItem3);
myList.addItem(sampleItem4);
myList.addEventListener(ListEvent.ITEM_CLICK, listItemSelected);
addChild(myList);

function listItemSelected(e:ListEvent):void {
    var cr:CellRenderer = myList.itemToCellRenderer(e.item) as CellRenderer;
    var listData:ListData = cr.listData;

    trace("You have selected row: " + listData.row);
}

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 affichée par l’objet de rendu pour l’objet de données fourni en fonction des propriétés label de l’objet. Cette méthode est destinée à être écrasée dans les sous-composants. Par exemple, List possède un labelField et un labelFunction dont dérive l’étiquette.

Paramètres

item:Object

Valeur renvoyée

String

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.

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.

Valeur renvoyée

Object — Elément qui a été supprimé.

Valeur émise

RangeError — Elément introuvable.

Eléments de l’API associés

removeAll()
removeItemAt()

removeItemAt

()

méthode

public function removeItemAt(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

Supprime l’élément présent à l’emplacement d’index spécifié. Les indices des éléments à ou après l’emplacement spécifié sont réduits d’une unité.

Paramètres

index:uint — Index de l’élément à supprimer du fournisseur de données.

Valeur renvoyée

Object — Elément qui a été supprimé.

Eléments de l’API associés

removeAll()
removeItem()
replaceItemAt()

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.

Valeur renvoyée

Object — Elément qui a été remplacé.

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

removeItemAt()

scrollToIndex

()

méthode

public function scrollToIndex(newCaretIndex:int):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

Fait féfiler la liste jusqu’à l’élément, à l’index spécifié. Lorsque l’index est hors de portée, la position de défilement ne change pas.

Paramètres

newCaretIndex:int — L’index auquel le défilement doit s’arrêter.

scrollToSelected

()

méthode

public function scrollToSelected():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

Fait défiler la liste jusqu’à l’élément, à l’emplacement indiqué par la valeur actuelle de la propriété selectedIndex.

Eléments de l’API associés

selectedIndex
scrollToIndex()

setRendererStyle

()

méthode

public function setRendererStyle(name:String, style:Object, column:uint = 0):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

Définit un style pour les fonctionnalités de rendu dans la liste.

Paramètres

	`name:String` — Nom du style à définir.

	`style:Object` — La valeur du style à définir.

	`column:uint` (default = `0`)

Eléments de l’API associés

clearRendererStyle()
getRendererStyle()

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée un composant List et utilise la méthode setRendererStyle() pour appliquer un format de texte aux éléments de la liste :


import fl.controls.List;

var myTextFormat:TextFormat = new TextFormat();
myTextFormat.font = "Comic Sans MS";

var myList:List = new List();
myList.addItem({label:"The quick brown fox..."});
myList.addItem({label:"The quick brown fox..."});
myList.addItem({label:"The quick brown fox..."});
myList.addItem({label:"The quick brown fox..."});
myList.addItem({label:"The quick brown fox..."});
myList.addItem({label:"The quick brown fox..."});
myList.setRendererStyle("textFormat", myTextFormat);
myList.width = 150;
myList.move(10, 10);
addChild(myList);

L’exemple suivant crée un composant DataGrid et utilise la méthode setRendererStyle() pour appliquer un format de texte aux éléments de la liste :


import fl.controls.DataGrid;

var myTextFormat:TextFormat = new TextFormat();
myTextFormat.font = "Comic Sans MS";

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("column1");
myDataGrid.addColumn("column2");
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.addItem({column1:"The quick brown fox...", column2:"...jumped over the lazy dog."});
myDataGrid.setStyle("headerTextFormat", myTextFormat);
myDataGrid.setRendererStyle("textFormat", myTextFormat);
myDataGrid.width = 300;
myDataGrid.move(10, 10);
addChild(myDataGrid);

L’exemple suivant crée un composant TileList et utilise la méthode setRendererStyle() pour appliquer un format de texte aux éléments de la liste :


import fl.controls.TileList;

var myTextFormat:TextFormat = new TextFormat();
myTextFormat.font = "Comic Sans MS";
myTextFormat.color = 0xFF0000;
myTextFormat.bold = true;

var myTileList:TileList = new TileList();
myTileList.addItem({label:"Image 1", source:"http://www.helpexamples.com/flash/images/image1.jpg"});
myTileList.addItem({label:"Image 2", source:"http://www.helpexamples.com/flash/images/image2.jpg"});
myTileList.addItem({label:"Image 3", source:"http://www.helpexamples.com/flash/images/image3.jpg"});
myTileList.setRendererStyle("textFormat", myTextFormat);
myTileList.columnWidth = 100;
myTileList.rowHeight = 67;
myTileList.columnCount = 3;
myTileList.rowCount = 1;
myTileList.move(10, 10);
addChild(myTileList);

L’exemple suivant crée un composant ComboBox et utilise la méthode setRendererStyle() pour appliquer un format de texte aux éléments de la liste :


import fl.controls.ComboBox;

var myTextFormat:TextFormat = new TextFormat();
myTextFormat.font = "Comic Sans MS";

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.addItem({label:"The quick brown fox..."});
myComboBox.textField.setStyle("textFormat", myTextFormat);
myComboBox.dropdown.setRendererStyle("textFormat", myTextFormat);
myComboBox.width = 150;
myComboBox.move(10, 10);
addChild(myComboBox);

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.

Valeur renvoyée

* — 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

sortItemsOn()
Array.sort()

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.

Valeur renvoyée

* — 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

sortItems()
DataProvider.sortOn()

Exemple ( Comment utiliser cet exemple )

L’exemple suivant trie une liste en fonction d’une valeur du fournisseur de données à l’aide de la méthode sortItemsOn() :


import fl.controls.List;
import fl.data.DataProvider;

var players:XML = <players>
        <player name="Player Q" avg="0.237" />
        <player name="Player W" avg="0.352" />
        <player name="Player E" avg="0.268" />
        <player name="Player R" avg="0.311" />
        <player name="Player T" avg="0.293" />
        <player name="Player Y" avg="0.33" />
    </players>;

var dp:DataProvider = new DataProvider(players);

var playerList:List = new List();
playerList.labelFunction = myLabelFunction;
playerList.dataProvider = dp;
playerList.sortItemsOn("avg", Array.NUMERIC | Array.DESCENDING);
playerList.move(10, 10);
playerList.setSize(160, 120);
addChild(playerList);

function myLabelFunction(item:Object):String {
    return item.name + " (" + Number(item.avg).toFixed(3) + ")";
}

Détails de l’événement

change

Evénement

Type d’objet d’évé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é lorsqu’un autre élément est sélectionné dans la liste.

La constante 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.

itemClick

Evénement

Type d’objet d’événement: fl.events.ListEvent
propriété ListEvent.type = fl.events.ListEvent.ITEM_CLICK

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 élément du composant.

L’événement click est distribué avant la modification de la valeur du composant. Pour identifier la ligne et la colonne qui ont été cliquées, employez les propriétés de l’objet event. N’utilisez pas les propriétés selectedIndex et selectedItem.

Définit la valeur de la propriété type d’un objet de l’événement itemClick.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`true`
`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`.

itemDoubleClick

Evénement

Type d’objet d’événement: fl.events.ListEvent
propriété ListEvent.type = fl.events.ListEvent.ITEM_DOUBLE_CLICK

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 rapidement à deux reprises sur un élément du composant. Contrairement à l’événement click, l’événement doubleClick est distribué lorsque la propriété selectedIndex du composant change.

Définit la valeur de la propriété type d’un objet de l’événement itemDoubleClick.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`true`
`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`.

itemRollOut

Evénement

Type d’objet d’évé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

Type d’objet d’évé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`.

Eléments de l’API associés

itemRollOut

rollOut

Evénement

Type d’objet d’événement: flash.events.MouseEvent
propriété MouseEvent.type = flash.events.MouseEvent.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 le composant.

Définit la valeur de la propriété type d’un objet d’événement rollOut.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`altKey`	`true` si la touche Alt est activée (Windows).
`bubbles`	`false`
`buttonDown`	`true` si le bouton principal de la souris est enfoncé ; `false` dans tous les autres cas.
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`commandKey`	`true` sur le Mac si la touche Commande est activée ; `false` si elle est désactivée. Toujours `false` sur Windows.
`controlKey`	`true` si la touche Ctrl ou Contrôle est activée ; `false` si elle est désactivée.
`ctrlKey`	`true` sous Windows ou Linux si la touche Ctrl est enfoncée. `true` sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur `false` est renvoyée.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`relatedObject`	Objet de la liste d’affichage sur lequel pointe actuellement le périphérique de pointage.
`localX`	Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
`localY`	Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
`movementX`	Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
`movementY`	Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
`shiftKey`	`true` si la touche Maj est activée ; `false` si elle ne l’est pas.
`stageX`	Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
`stageY`	Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
`target`	Occurrence d’InteractiveObject sous le périphérique de pointage. 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.

Eléments de l’API associés

rollOver

Evénement

Type d’objet d’événement: flash.events.MouseEvent
propriété MouseEvent.type = flash.events.MouseEvent.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 le composant.

Définit la valeur de la propriété type d’un objet d’événement rollOver.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`altKey`	`true` si la touche Alt est activée (Windows).
`bubbles`	`false`
`buttonDown`	`true` si le bouton principal de la souris est enfoncé ; `false` dans tous les autres cas.
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`commandKey`	`true` sur le Mac si la touche Commande est activée ; `false` si elle est désactivée. Toujours `false` sur Windows.
`controlKey`	`true` si la touche Ctrl ou Contrôle est activée ; `false` si elle est désactivée.
`ctrlKey`	`true` sous Windows ou Linux si la touche Ctrl est enfoncée. `true` sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur `false` est renvoyée.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`relatedObject`	Objet de la liste d’affichage sur lequel pointait le périphérique de pointage.
`localX`	Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
`localY`	Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
`movementX`	Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
`movementY`	Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
`shiftKey`	`true` si la touche Maj est activée ; `false` si elle ne l’est pas.
`stageX`	Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
`stageY`	Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
`target`	Occurrence d’InteractiveObject sous le périphérique de pointage. 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.

Eléments de l’API associés

rollOut

scroll

Evénement

Type d’objet d’évé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 effectue un défilement horizontal ou vertical.

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

Informations juridiques | Politique de confidentialité en ligne

SelectableList - AS3 Flash

Classes x

allowMultipleSelection

dataProvider

length

maxHorizontalScrollPosition

rowCount

selectable

selectedIndex

selectedIndices

selectedItem

selectedItems

SelectableList

addItem

addItemAt

clearRendererStyle

clearSelection

getItemAt

getNextIndexAtLetter

getRendererStyle

getStyleDefinition

invalidateItem

invalidateItemAt

invalidateList

isItemSelected

itemToCellRenderer

itemToLabel

removeAll

removeItem

removeItemAt

replaceItemAt

scrollToIndex

scrollToSelected

setRendererStyle

sortItems

sortItemsOn

change

itemClick

itemDoubleClick

itemRollOut

itemRollOver

rollOut

rollOver

scroll