Flash CS4 Professional ActionScript 2.0

Classe UIScrollBar

Héritage MovieClip > Classe UIObject > Classe UIComponent > ScrollBar > UIScrollBar

Nom de classe ActionScript mx.controls.UIScrollBar

Les propriétés de la classe UIScrollBar vous permettent de régler la position et le volume de défilement lorsque l'utilisateur clique sur les flèches ou le rail de défilement.

Contrairement à la plupart des autres composants, les événements sont diffusés lorsque le bouton de la souris est enfoncé et continuent à diffuser jusqu'à ce que l'utilisateur relâche le bouton de la souris.

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.UIScrollBar.version);

REMARQUE

 

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

Méthodes de la classe UIScrollBar

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

Méthode

Description

UIScrollBar.setScrollProperties()

Définit la plage de défilement de la barre de défilement ainsi que la taille du champ de texte à laquelle la barre de défilement est associée.

UIScrollBar.setScrollTarget()

Affecte la barre de défilement à un champ de texte.

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

Le tableau suivant répertorie les méthodes de la classe UIScrollBar héritées de la classe UIObject. Pour appeler ces méthodes à partir de l'objet UIScrollBar, utilisez le formulaire UIScrollBarInstance.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 pour 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.

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

Le tableau suivant répertorie les méthodes de la classe UIScrollBar héritées de la classe UIComponent. Pour appeler ces méthodes à partir de l'objet UIScrollBar, utilisez le formulaire UIScrollBarInstance.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 UIScrollBar

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

Propriété

Description

UIScrollBar.lineScrollSize

Nombre de lignes ou de pixels qui défilent lorsque l'utilisateur clique sur les boutons fléchés de la barre de défilement.

UIScrollBar.pageScrollSize

Nombre de lignes ou de pixels qui défilent lorsque l'utilisateur clique sur le rail de la barre de défilement.

UIScrollBar.scrollPosition

Position de défilement courante de la barre de défilement.

UIScrollBar._targetInstanceName

Nom d'instance du champ de texte associée à l'occurrence de UIScrollBar.

UIScrollBar.horizontal

Valeur booléenne indiquant si la barre de défilement est orientée à la verticale (false), par défaut, ou à l'horizontale (true).

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

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

Propriété

Description

UIObject.bottom

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

UIObject.height

Lecture seule ; hauteur de l'objet, en pixels.

UIObject.left

Lecture seule ; bord gauche de l'objet, en pixels.

UIObject.right

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

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

Lecture seule ; renvoie la position du bord supérieur de l'objet par rapport à son parent.

UIObject.visible

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

UIObject.width

Lecture seule ; largeur de l'objet, en pixels.

UIObject.x

Lecture seule ; bord gauche de l'objet, en pixels.

UIObject.y

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

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

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

Le tableau suivant présente l'événement de la classe UIScrollBar.

Evénement

Description

UIScrollBar.scroll

Diffusé lorsque vous cliquez n'importe où sur la barre de défilement.

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

Le tableau suivant répertorie les événements de la classe UIScrollBar 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 UIScrollBar 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.