Flash CS4 Professional ActionScript 2.0

Classe TextArea

Héritage MovieClip > Classe UIObject > Classe UIComponent > View > ScrollView > TextArea

Nom de classe ActionScript mx.controls.TextArea

Les propriétés de la classe TextArea vous permettent de définir le contenu, le formatage et la position horizontale et verticale du texte lors de l'exécution. Vous pouvez également indiquer si le champ est modifiable et s'il s'agit d'un champ Mot de passe. Vous pouvez également limiter le nombre de caractères que l'utilisateur peut saisir.

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

Le composant TextArea annule le rectangle de focus par défaut de Flash Player et dessine un rectangle de focus personnalisé avec des angles arrondis.

Le composant TextArea prend en charge les styles CSS et tout style HTML pris en charge par Flash Player.

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

REMARQUE

 

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

Méthodes de la classe TextArea

La classe TextArea ne présente pas de méthodes exclusives.

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

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

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

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

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

Propriété

Description

TextArea.editable

Valeur booléenne indiquant si le champ est modifiable (true) ou non (false).

TextArea.hPosition

Définit la position du texte horizontalement dans le champ.

TextArea.hScrollPolicy

Indique si la barre de défilement horizontale est toujours affichée ("on"), jamais affichée ("off"), ou affichée seulement lorsque nécessaire ("auto").

TextArea.html

Valeur booléenne qui indique si la zone de texte peut être mise au format HTML.

TextArea.length

Lecture seule : nombre de caractères contenus dans la zone de texte.

TextArea.maxChars

Nombre maximal de caractères que la zone de texte peut contenir.

TextArea.maxHPosition

Lecture seule ; valeur maximale de TextArea.hPosition.

TextArea.maxVPosition

Lecture seule ; valeur maximale de TextArea.vPosition.

TextArea.password

Valeur booléenne indiquant si le champ est un champ de mot de passe (true) ou non (false).

TextArea.restrict

Jeu de caractères qu'un utilisateur peut entrer dans la zone de texte.

TextArea.styleSheet

Associe une feuille de style au composant TextArea spécifié.

TextArea.text

Contenu du texte d'un composant TextArea.

TextArea.vPosition

Nombre indiquant la position du défilement vertical.

TextArea.vScrollPolicy

Indique si la barre de défilement verticale est toujours affichée ("on"), jamais affichée ("off"), ou affichée seulement lorsque nécessaire ("auto").

TextArea.wordWrap

Valeur booléenne indiquant si le texte est renvoyé à la ligne automatiquement (true) ou non (false).

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

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

Lecture seule ; 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 TextArea héritées de la classe UIComponent. Pour accéder à ces propriétés à partir de l'objet TextArea, utilisez le formulaire TextAreaInstance.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 TextArea

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

Evénement

Description

TextArea.change

Indique aux écouteurs que le texte a été modifié.

TextArea.scroll

Indique aux écouteurs que l'utilisateur a fait défiler du texte.

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

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