Flash CS4 Professional ActionScript 2.0

Classe ProgressBar

Héritage MovieClip > Classe UIObject > ProgressBar

Nom de classe ActionScript mx.controls.ProgressBar

La définition d'une propriété de la classe ProgressBar avec ActionScript annule le paramètre du même nom défini dans l'inspecteur des propriétés ou des composants.

Toutes les classes de composants ont une propriété version qui correspond à une propriété de classe. Les propriétés de classe ne sont disponibles que pour la classe elle-même. La propriété version renvoie une chaîne qui indique la version du composant. Pour accéder à cette propriété, utilisez le code suivant :

trace(mx.controls.ProgressBar.version);

REMARQUE

 

Le code trace(myProgressBarInstance.version); renvoie undefined.

Méthodes de la classe ProgressBar

Le tableau suivant présente la méthode de la classe ProgressBar.

Méthode

Description

ProgressBar.setProgress()

Définit l'état de la barre de progression pour refléter le niveau de progression atteint lorsque la barre de progression est en mode manual

Méthodes héritées de la classe UIObject

Le tableau suivant répertorie les méthodes de la classe ProgressBar héritées de la classe UIObject. Pour appeler ces méthodes à partir de l'objet ProgressBar, utilisez le formulaire ProgressBar.methodName.

Méthode

Description

UIObject.createClassObject()

Crée un objet dans la classe spécifiée.

UIObject.createObject()

Crée un sous-objet dans un objet.

UIObject.destroyObject()

Détruit une occurrence de composant.

UIObject.doLater()

Appelle une fonction lorsque les paramètres ont été définis dans les inspecteurs des propriétés et des composants.

UIObject.getStyle()

Obtient la propriété de style de l'objet ou de la déclaration
de style.

UIObject.invalidate()

Marque l'objet de sorte qu'il soit redessiné dans le prochain intervalle d'image.

UIObject.move()

Déplace l'objet à l'emplacement demandé.

UIObject.redraw()

Force la validation de l'objet pour qu'il soit dessiné dans l'image actuelle.

UIObject.setSize()

Redimensionne l'objet à la taille demandée.

UIObject.setSkin()

Définit une enveloppe dans l'objet.

UIObject.setStyle()

Définit la propriété de style sur l'objet ou la déclaration
de style.

Propriétés de la classe ProgressBar

Le tableau suivant répertorie les propriétés de la classe ProgressBar.

Propriété

Description

ProgressBar.conversion

Nombre utilisé pour convertir la valeur courante des octets chargés et les valeurs totales des octets chargés.

ProgressBar.direction

Direction dans laquelle la barre de progression se remplit.

ProgressBar.indeterminate

Indique si la taille de la source de chargement est inconnue.

ProgressBar.label

Texte accompagnant la barre de progression.

ProgressBar.labelPlacement

Emplacement de l'étiquette par rapport à la barre de progression.

ProgressBar.maximum

Valeur maximum de la barre de progression en mode manuel.

ProgressBar.minimum

Valeur minimum de la barre de progression en mode manuel.

ProgressBar.mode

Mode dans lequel la barre de progression charge le contenu.

ProgressBar.percentComplete

Lecture seule : nombre indiquant le pourcentage chargé.

ProgressBar.source

Contenu à charger.

ProgressBar.value

Lecture seule ; indique le niveau de progression atteint.

Propriétés héritées de la classe UIObject

Le tableau suivant répertorie les propriétés de la classe ProgressBar héritées de la classe UIObject. Pour appeler ces propriétés à partir de l'objet ProgressBar, utilisez le formulaire ProgressBar.propertyName.

Propriété

Description

UIObject.bottom

Position du bord inférieur de l'objet par rapport au bord inférieur de son parent. Lecture seule.

UIObject.height

Hauteur de l'objet, en pixels. Lecture seule.

UIObject.left

Bord gauche de l'objet, en pixels. Lecture seule.

UIObject.right

Position du bord droit de l'objet par rapport au bord droit de son parent. Lecture seule.

UIObject.scaleX

Nombre indiquant le facteur de redimensionnement dans la direction x de l'objet par rapport à son parent.

UIObject.scaleY

Nombre indiquant le facteur de redimensionnement dans la direction y de l'objet par rapport à son parent.

UIObject.top

Position du bord supérieur de l'objet par rapport à son parent. Lecture seule.

UIObject.visible

Valeur booléenne indiquant si l'objet est visible (true) ou non (false).

UIObject.width

Largeur de l'objet, en pixels. Lecture seule.

UIObject.x

Bord gauche de l'objet, en pixels. Lecture seule.

UIObject.y

Bord supérieur de l'objet, en pixels. Lecture seule.

Evénements de la classe ProgressBar

Le tableau suivant répertorie les événements de la classe ProgressBar.

Evénement

Description

ProgressBar.complete

Déclenché une fois le téléchargement terminé.

ProgressBar.progress

Déclenché pendant le chargement du contenu en mode manual ou polled.

Evénements hérités de la classe UIObject

Le tableau suivant répertorie les événements de la classe ProgressBar hérités de la classe UIObject. Pour appeler ces événements à partir de l'objet ProgressBar, utilisez le formulaire ProgressBar.eventName.

Evénement

Description

UIObject.draw

Diffusé lorsqu'un objet est sur le point de dessiner ses graphiques.

UIObject.hide

Diffusé lorsqu'un objet passe de l'état visible à l'état invisible.

UIObject.load

Diffusé lorsque des sous-objets sont créés.

UIObject.move

Diffusé lorsque l'objet a été déplacé.

UIObject.resize

Diffusé lorsqu'un objet a été redimensionné.

UIObject.reveal

Diffusé lorsqu'un objet passe de l'état invisible à l'état visible.

UIObject.unload

Diffusé lorsque les sous-objets sont purgés.