Flash CS4 Professional ActionScript 2.0

Classe Loader

Héritage MovieClip > Classe UIObject > Classe UIComponent > View > Loader

Nom de classe ActionScript mx.controls.Loader

Les propriétés de la classe Loader vous permettent de définir le contenu de sorte qu'il se charge et contrôle sa propre progression de chargement lors de l'exécution.

La définition d'une propriété de la classe Loader avec ActionScript annule le paramètre du même nom défini dans l'inspecteur Propriétés ou l'inspecteur 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 sont uniquement disponibles sur 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.Loader.version);

REMARQUE

 

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

Méthodes de la classe Loader

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

Méthode

Description

Loader.load()

Charge le contenu spécifié par la propriété contentPath.

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

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

Méthode

Description

UIObject.createClassObject()

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

UIObject.createObject()

Crée un sous-objet sur un objet.

UIObject.destroyObject()

Détruit une occurrence de composant.

UIObject.doLater()

Appelle une fonction lorsque des paramètres ont été définis dans les inspecteurs de propriétés et de 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 courante.

UIObject.setSize()

Redimensionne l'objet aux dimensions demandées.

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.

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

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

Méthode

Description

UIComponent.getFocus()

Renvoie une référence à l'objet ayant le focus.

UIComponent.setFocus()

Attribue le focus à l'occurrence de composant.

Propriétés de la classe Loader

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

Propriété

Description

Loader.autoLoad

Valeur booléenne indiquant si le contenu se charge automatiquement (true) ou si vous devez appeler Loader.load() (false).

Loader.bytesLoaded

Propriété en lecture seule indiquant le nombre d'octets ayant été chargés.

Loader.bytesTotal

Propriété en lecture seule indiquant le nombres d'octets du contenu.

Loader.content

Référence au contenu du chargeur. Cette propriété est en lecture seule.

Loader.contentPath

Chaîne indiquant l'URL du contenu à charger.

Loader.percentLoaded

Nombre indiquant le pourcentage de contenu chargé.
Cette propriété est en lecture seule.

Loader.scaleContent

Valeur booléenne indiquant si le contenu est dimensionné pour s'ajuster au chargeur (true) ou si le chargeur est dimensionné pour s'ajuster au contenu (false).

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

Le tableau suivant répertorie les propriétés de la classe Loader héritées de la classe UIObject. Pour accéder à ces propriétés à partir de l'objet Loader, utilisez le formulaire LoaderInstance.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.

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

Le tableau suivant répertorie les propriétés de la classe Loader héritées de la classe UIComponent. Pour accéder à ces propriétés à partir de l'objet Loader, utilisez le formulaire LoaderInstance.propertyName.

Propriété

Description

UIComponent.enabled

Indique si le composant peut recevoir le focus et la saisie.

UIComponent.tabIndex

Nombre indiquant l'ordre de tabulation pour un composant dans un document.

Evénements de la classe Loader

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

Evénement

Description

Loader.complete

Déclenché à la fin du chargement du contenu.

Loader.progress

Déclenché pendant le chargement du contenu.

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

Le tableau suivant répertorie les événements de la classe Loader hérités de la classe UIObject.

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.

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

Le tableau suivant répertorie les événements de la classe Loader hérités de la classe UIComponent.

Evénement

Description

UIComponent.focusIn

Diffusé lorsqu'un objet reçoit le focus.

UIComponent.focusOut

Diffusé lorsqu'un objet perd le focus.

UIComponent.keyDown

Diffusé lorsqu'une touche est enfoncée.

UIComponent.keyUp

Diffusé lorsqu'une touche est relâchée.