ProgressBar

Package	fl.controls
Classe	public class ProgressBar
Héritage	ProgressBar UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher 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

Le composant ProgressBar affiche la progression du chargement du contenu. Le composant ProgressBar permet généralement d’afficher le statut des images, ainsi qu’une partie des applications, pendant leur chargement. Le processus de chargement peut être déterminé ou indéterminé. Une barre de progression déterminée est une représentation linéaire de la progression d’une tâche dans le temps. Elle est utilisée lorsque la quantité de contenu à charger est connue. Lorsque l’état d’avancement exact n’est pas connu, la barre de défilement est indéterminée et s’affiche avec des rayures pour indiquer que la source de chargement est inconnue.

Consulter les exemples

Eléments de l’API associés

ProgressBarDirection
ProgressBarMode

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
		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
		direction : String Indique le sens de remplissage de la barre de progression.	ProgressBar
		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
		indeterminate : Boolean Lit ou définit une valeur qui indique le type de remplissage employé par la barre de progression et si la source de chargement est connue ou inconnue.	ProgressBar
		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
		maximum : Number Lit ou définit la valeur maximale de la barre de progression lorsque la propriété ProgressBar.mode est définie sur ProgressBarMode.MANUAL.	ProgressBar
		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
		minimum : Number Lit ou définit la valeur minimale de la barre de progression lorsque la propriété ProgressBar.mode est définie sur ProgressBarMode.MANUAL.	ProgressBar
		mode : String Lit ou définit la méthode à utiliser pour mettre à jour la barre de progression.	ProgressBar
		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
		percentComplete : Number [lecture seule] Lit un nombre compris entre 0 et 100 qui indique le pourcentage de contenu déjà chargé.	ProgressBar
		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
		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
		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
		source : Object Lit ou définit une référence au contenu qui est chargé et pour lequel la barre de progression permet de mesurer l’état d’avancement.	ProgressBar
		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
		useHandCursor : Boolean Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque le pointeur survole un sprite dont la propriété buttonMode est définie sur true.	Sprite
		value : Number Lit ou définit une valeur qui indique la progression réalisée jusqu’à présent, au cours de l’opération de chargement.	ProgressBar
		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
		ProgressBar() Crée une nouvelle occurrence du composant ProgressBar.	ProgressBar
		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
		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
		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
		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
		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.	ProgressBar
		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
		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
		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
		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
		requestSoftKeyboard():Boolean Affiche un clavier virtuel.	InteractiveObject
		reset():void Redéfinit la barre de progression pour la nouvelle opération de chargement.	ProgressBar
		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
		setProgress(value:Number, maximum:Number):void Définit l’état de la barre pour qu’elle reflète l’avancée de la progression lorsque le mode manuel est utilisé.	ProgressBar
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		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
		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
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
complete	Distribué lorsque le chargement se termine.	ProgressBar
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
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
progress	Distribué pendant le chargement du contenu en mode event ou polled.	ProgressBar
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 l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject.	InteractiveObject
rollOver	Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.	InteractiveObject
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
barPadding	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 l’indicateur de la barre de progression et le rail, en pixels. La valeur par défaut est `0`.	ProgressBar
barSkin	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 barre de progression déterminée. La valeur par défaut est `ProgressBar_barSkin`.	ProgressBar
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
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
icon	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 par défaut. La définition de tout autre style d’icône écrase ce paramètre. La valeur par défaut est `null`.	ProgressBar
indeterminateBar	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 à utiliser comme rendu pour l’animation de barre indéterminée. Il s’agit d’un style avancé. La valeur par défaut est `fl.controls.progressBarClasses.IndeterminateBar`.	ProgressBar
indeterminateSkin	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 barre de progression indéterminée. Elle est transmise au rendu de la barre indéterminée, qui est spécifié par le style `indeterminateBar`. La valeur par défaut est `ProgressBar_indeterminateSkin`.	ProgressBar
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
trackSkin	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 rail d’indication de progression. La valeur par défaut est `ProgressBar_trackSkin`.	ProgressBar

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é

direction

propriété

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

Indique le sens de remplissage de la barre de progression. La valeur ProgressBarDirection.RIGHT indique que la barre de progression se remplit de gauche à droite. La valeur ProgressBarDirection.LEFT indique que la barre de progression se remplit de droite à gauche.

La valeur par défaut est ProgressBarDirection.RIGHT.

Implémentation
public function get direction():String
public function set direction(value:String):void

Eléments de l’API associés

ProgressBarDirection

Exemple ( Comment utiliser cet exemple )

L’exemple suivant montre la différence entre une barre de progression chargeant à partir de la gauche et une barre de progression chargeant à partir de la droite. Pour tester cela localement, remplacez testPath par un fichier volumineux :

 
import fl.controls.ProgressBar;
import fl.controls.ProgressBarDirection;

var testPath:String = "largeVideo.flv";
var loader:URLLoader = new URLLoader();
loader.load(new URLRequest(testPath));

var leftProgressBar:ProgressBar = new ProgressBar();
leftProgressBar.move(10,10);
leftProgressBar.direction = ProgressBarDirection.LEFT;
leftProgressBar.source = loader;
addChild(leftProgressBar);

var rightProgressBar:ProgressBar = new ProgressBar();
rightProgressBar.move(10,40);
rightProgressBar.source = loader;
rightProgressBar.direction = ProgressBarDirection.RIGHT;
addChild(rightProgressBar);

indeterminate

propriété

indeterminate: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 qui indique le type de remplissage employé par la barre de progression et si la source de chargement est connue ou inconnue. La valeur true indique que la barre de progression comporte un remplissage rayé et que sa source de chargement est inconnue. La valeur false indique que la barre de progression comporte un remplissage uni et que sa source de chargement est connue.

Cette propriété peut également être définie lorsque le mode de la barre de progression est défini sur ProgressBarMode.MANUAL.

La valeur par défaut est true.

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

Eléments de l’API associés

mode
ProgressBarMode
IndeterminateBar

maximum

propriété

maximum:Number

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Lit ou définit la valeur maximale de la barre de progression lorsque la propriété ProgressBar.mode est définie sur ProgressBarMode.MANUAL.

La valeur par défaut est 0.

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

Eléments de l’API associés

minimum
percentComplete
value
ProgressBarMode.MANUAL

minimum

propriété

minimum:Number

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Lit ou définit la valeur minimale de la barre de progression lorsque la propriété ProgressBar.mode est définie sur ProgressBarMode.MANUAL.

La valeur par défaut est 0.

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

Eléments de l’API associés

maximum
percentComplete
value
ProgressBarMode.MANUAL

mode

propriété

mode:String

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Lit ou définit la méthode à utiliser pour mettre à jour la barre de progression.

Les valeurs suivantes sont possibles pour cette propriété :

ProgressBarMode.EVENT
ProgressBarMode.POLLED
ProgressBarMode.MANUAL

Les modes event et polled sont les modes les plus courants. En mode event, la propriété source spécifie le contenu de chargement qui génère les événements progress et complete ; vous devez utiliser un objet UILoader dans ce mode. En mode polled, la propriété source spécifie le contenu à charger, tel qu’une classe personnalisée, qui expose les propriétés bytesLoaded et bytesTotal. Tout objet qui expose ces propriétés peut être utilisé en tant que source en mode polled.

Vous pouvez également utiliser le composant ProgressBar en mode manual en définissant manuellement les propriétés maximum et minimum en appelant la méthode ProgressBar.setProgress().

La valeur par défaut est ProgressBarMode.EVENT.

Implémentation
public function get mode():String
public function set mode(value:String):void

Eléments de l’API associés

ProgressBarMode

percentComplete

propriété

percentComplete:Number [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 un nombre compris entre 0 et 100 qui indique le pourcentage de contenu déjà chargé.

Pour modifier la valeur du pourcentage, appliquez la méthode setProgress().

La valeur par défaut est 0.

Implémentation
public function get percentComplete():Number

Eléments de l’API associés

maximum
minimum
setProgress()
value

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée des occurrences du composant ProgressBar et Label pour afficher l’état de la barre de progression :


import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.indeterminate = false;
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.maximum = 256;
myProgressBar.setSize(320, 16);
myProgressBar.move(10, 10)
addChild(myProgressBar);

var myLabel:Label = new Label();
myLabel.text = "";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myProgressBar.x, myProgressBar.y + myProgressBar.height);
addChild(myLabel);

var t:Timer = new Timer(150);
t.addEventListener(TimerEvent.TIMER, timerHandler);
t.start();

function timerHandler(event:TimerEvent):void {
    myProgressBar.setProgress(myProgressBar.value + 1, myProgressBar.maximum);
    if (myProgressBar.percentComplete == 100) {
        myProgressBar.setProgress(0, myProgressBar.maximum);
    }
    myLabel.text = int(myProgressBar.value) + " of " + int(myProgressBar.maximum) + " (" + int(myProgressBar.percentComplete) + "%)";
}

L’exemple suivant montre comment surveiller la progression du chargement en accédant à la propriété percentLoaded. La variable dataPath doit d’abord être définie sur un fichier distant :

import fl.controls.ProgressBar;
import fl.controls.Label

var dataPath:String = "test.txt";
var loader:URLLoader = new URLLoader();
loader.load(new URLRequest(dataPath));

var progressReport:Label = new Label();
progressReport.move(10,30);
progressReport.autoSize = TextFieldAutoSize.LEFT;
addChild(progressReport);

var pb:ProgressBar = new ProgressBar();
pb.move(10,10);
pb.source = loader;
pb.addEventListener(ProgressEvent.PROGRESS,updateProgressReport);
addChild(pb);

function updateProgressReport(e:ProgressEvent):void {
    progressReport.text = Math.round(pb.percentComplete) + "% Loaded";
}

source

propriété

source: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 une référence au contenu qui est chargé et pour lequel la barre de progression permet de mesurer l’état d’avancement. Une utilisation type de cette propriété permet de la définir sur un composant UILoader.

N’utilisez cette propriété qu’en mode event ou polled.

La valeur par défaut est null.

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

Exemple ( Comment utiliser cet exemple )

L’exemple suivant montre comment relier une barre de progression à un chargeur en définissant la propriété source. Pour que la barre de progression montre la progression du chargement, la variable dataPath doit d’abord être définie sur un fichier distant :

import fl.controls.ProgressBar;

var dataPath:String = "test.txt";
var loader:URLLoader = new URLLoader();
loader.load(new URLRequest(dataPath));

var pb:ProgressBar = new ProgressBar();
pb.source = loader;
addChild(pb);

L’exemple suivant définit la propriété source d’une barre de progression sur un panneau défilant :


import fl.containers.ScrollPane;
import fl.controls.ProgressBar;

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.source = "http://www.helpexamples.com/flash/images/image3.jpg";
addChild(myScrollPane);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.width = myScrollPane.width;
myProgressBar.move(myScrollPane.x, myScrollPane.y - myProgressBar.height);
myProgressBar.source = myScrollPane;
addChild(myProgressBar);

value

propriété

value:Number

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Lit ou définit une valeur qui indique la progression réalisée jusqu’à présent, au cours de l’opération de chargement. Cette valeur est un nombre compris entre les valeurs minimum et maximum.

La valeur par défaut est 0.

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

Eléments de l’API associés

maximum
minimum
percentComplete

Détails du constructeur

()

Constructeur

public function ProgressBar()

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

Détails de la méthode

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

reset

()

méthode

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

Redéfinit la barre de progression pour la nouvelle opération de chargement.

setProgress

()

méthode

public function setProgress(value:Number, maximum:Number):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 l’état de la barre pour qu’elle reflète l’avancée de la progression lorsque le mode manual est utilisé. L’argument value est attribué à la propriété value et l’argument maximum à la propriété maximum. La propriété minimum n’est pas modifiée.

Paramètres

	`value:Number` — Une valeur décrivant la progression qui s’est accomplie jusqu’à présent.

	`maximum:Number` — La valeur de progression maximale de la barre de progression.

Eléments de l’API associés

maximum
value
ProgressBarMode.manual

Détails de l’événement

complete

Evénement

Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.COMPLETE

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 chargement se termine.

La constante Event.COMPLETE définit la valeur de la propriété type d’un objet événement complete.

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

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Objet réseau dont le chargement est terminé.

Exemple ( Comment utiliser cet exemple )

L’exemple suivant charge une image externe à l’aide d’un composant UILoader puis, lorsque le chargement est terminé, masque un composant ProgressBar et Label :


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;

var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.source = url;
myUILoader.move(10, 10);
myUILoader.scaleContent = false;
myUILoader.load();

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.source = myUILoader;
myProgressBar.move(myUILoader.x, myUILoader.y);
myProgressBar.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myProgressBar.addEventListener(Event.COMPLETE, completeHandler);
addChild(myProgressBar)

var myLabel:Label = new Label();
myLabel.text = "xx";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myProgressBar.x, myProgressBar.y + myProgressBar.height);
addChild(myLabel);

function progressHandler(event:ProgressEvent):void {
    trace("progress:", event.bytesLoaded, event.bytesTotal, int(event.currentTarget.percentComplete) + "%");
    myLabel.text = event.bytesLoaded + " of " + event.bytesTotal + " bytes loaded.";
}

function completeHandler(event:Event):void {
    trace("complete:");
    myProgressBar.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myProgressBar.removeEventListener(Event.COMPLETE, completeHandler);
    removeChild(myProgressBar);
    removeChild(myLabel);
    
    addChild(myUILoader);
}

progress

Evénement

Type d’objet d’événement: flash.events.ProgressEvent
propriété ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

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é pendant le chargement du contenu en mode event ou polled.

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

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

Propriété	Valeur
`bubbles`	`false`
`bytesLoaded`	Nombre d’éléments ou d’octets chargés lors du traitement de l’événement par l’écouteur.
`bytesTotal`	Nombre total d’éléments ou d’octets qui seront chargés si le processus de chargement aboutit.
`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 indiquant la progression.

Exemple ( Comment utiliser cet exemple )

L’exemple suivant charge une image externe à l’aide d’un composant UILoader puis, lorsque le chargement est terminé, masque un composant ProgressBar et Label :


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;

var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.source = url;
myUILoader.move(10, 10);
myUILoader.scaleContent = false;
myUILoader.load();

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.source = myUILoader;
myProgressBar.move(myUILoader.x, myUILoader.y);
myProgressBar.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myProgressBar.addEventListener(Event.COMPLETE, completeHandler);
addChild(myProgressBar)

var myLabel:Label = new Label();
myLabel.text = "xx";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myProgressBar.x, myProgressBar.y + myProgressBar.height);
addChild(myLabel);

function progressHandler(event:ProgressEvent):void {
    trace("progress:", event.bytesLoaded, event.bytesTotal, int(event.currentTarget.percentComplete) + "%");
    myLabel.text = event.bytesLoaded + " of " + event.bytesTotal + " bytes loaded.";
}

function completeHandler(event:Event):void {
    trace("complete:");
    myProgressBar.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myProgressBar.removeEventListener(Event.COMPLETE, completeHandler);
    removeChild(myProgressBar);
    removeChild(myLabel);
    
    addChild(myUILoader);
}

Eléments de l’API associés

ProgressBarMode.EVENT
ProgressBarMode.POLLED

Exemples Comment utiliser cet exemple

ProgressBarExample.as

Cet exemple montre comment incrémenter manuellement un composant ProgressBar.

Ajoutez les composants ProgressBar, Label et Button dans votre bibliothèque.
Enregistrez ce code sous le nom ProgressBarExample.as dans le même répertoire que votre fichier FLA.
Dans le fichier FLA, définissez DocumentClass sur ProgressBarExample.

package
{
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import fl.controls.ProgressBar;
    import fl.controls.ProgressBarMode;
    import fl.controls.Button;
    
    public class ProgressBarExample extends Sprite
    {
        private var j:uint;
        private var pb:ProgressBar;
        private var fakeProgressCount:uint;
        
        public function ProgressBarExample() {
            setupProgressBar();    
            setupButton();
        }
        private function advancePreloader(e:MouseEvent):void {
            fakeProgressCount = fakeProgressCount == 100 ? 0 : fakeProgressCount + 10;
            pb.setProgress(fakeProgressCount, 100);
        }
        private function setupButton():void {
            var b:Button = new Button();
            b.move(10,30);
            b.setSize(120,20);
            b.label = "Increment Progress";
            b.addEventListener(MouseEvent.CLICK,advancePreloader);
            addChild(b);
        }
        private function setupProgressBar():void {
            fakeProgressCount = 0;
            pb = new ProgressBar();
            pb.mode = ProgressBarMode.MANUAL;
            pb.move(10,10);
            addChild(pb);
        }
    }
}

Informations juridiques | Politique de confidentialité en ligne

ProgressBar - AS3 Flash

Classes x

direction

indeterminate

maximum

minimum

mode

percentComplete

source

value

ProgressBar

getStyleDefinition

reset

setProgress

complete

progress