T > TextField (objet)

TextField (objet)

Tous les champs de texte dynamique et de saisie d'une animation Flash sont des occurrences de l'objet TextField. Vous pouvez donner un nom d'occurrence à un champ de texte dans l'inspecteur des propriétés et utiliser les méthodes et propriétés de l'objet TextField pour le manipuler avec ActionScript. Les noms d'occurrence TextField sont affichés dans l'explorateur d'animations et dans la boîte de dialogue Insérer un chemin cible du panneau Actions.

L'objet TextField hérite de l'objet Object.

Pour créer un champ de texte de façon dynamique, vous pouvez utiliser la méthode MovieClip.createTextField.

L'objet TextField est supporté par Flash Player 6 et les versions suivantes de Flash Player.

 
Méthodes de l'objet TextField

Méthode	Description
TextField.addListener	Enregistre un objet pour la réception de notification lorsque les événements onChanged et onScroller sont invoqués.
TextField.getDepth	Renvoie la profondeur d'un champ de texte.
TextField.getNewTextFormat	Lit le format de texte par défaut affecté au texte nouvellement inséré.
TextField.removeListener	Supprime un objet d'écoute.
TextField.removeTextField	Supprime un champ de texte créé avec MovieClip.createTextField.
TextField.setNewTextFormat	Définit un objet de format de texte pour le texte qui est inséré par un utilisateur ou par une méthode.
TextField.replaceSel	Remplace la sélection actuelle.
TextField.setTextFormat	Définit le format de texte par défaut affecté au texte nouvellement inséré.

 
Propriétés de l'objet TextField

Propriété	Description
TextField._alpha	La valeur de transparence d'une occurrence de champ de texte.
TextField.autoSize	Contrôle le dimensionnement et l'alignement automatique des champs de texte.
TextField.background	Indique si le champ de texte a un remplissage d'arrière-plan.
TextField.backgroundColor	Indique la couleur du remplissage d'arrière-plan.
TextField.border	Indique si le champ de texte a une bordure.
TextField.borderColor	Indique la couleur de la bordure.
TextField.bottomScroll	La dernière ligne visible dans un champ de texte.
TextField.embedFonts	Indique si le champ de texte utilise des polices vectorielles intégrées ou des polices de périphérique.
TextField._highquality	Indique la qualité de rendu de l'animation.
TextField._height	La hauteur d'une occurrence de champ de texte, en pixels. Cela n'affecte que le cadre de délimitation du champ de texte, pas l'épaisseur de la bordure ou la taille du texte.
TextField.hscroll	Indique la valeur de défilement horizontal d'un champ de texte.
TextField.html	Indique la position de défilement maximum d'un champ de texte.
TextField.htmlText	Contient la représentation HTML du contenu d'un champ de texte.
TextField.length	Le nombre de caractères d'un champ de texte.
TextField.maxChars	La quantité maximum de caractères qu'un champ de texte peut contenir.
TextField.maxhscroll	La valeur maximum de TextField.hscroll.
TextField.maxscroll	La valeur maximum de TextField.scroll.
TextField.multiline	Indique si le champ de texte contient plusieurs lignes.
TextField._name	Le nom d'occurrence d'une occurrence de champ de texte.
TextField._parent	Une référence à l'occurrence parent de cette occurrence ; de type Button ou MovieClip.
TextField.password	Indique si un champ de texte masque les caractères saisis.
TextField._quality	Indique la qualité de rendu d'une animation
TextField.restrict	Le jeu de caractères qu'un utilisateur peut rentrer dans un champ de texte.
TextField._rotation	Le degré de rotation d'une occurrence de champ de texte.
TextField.scroll	Indique la position de défilement actuelle d'un champ de texte.
TextField.selectable	Indique si un champ de texte est sélectionnable.
TextField._soundbuftime	La durée nécessaire de mise en tampon d'un son avant sa lecture en flux continu.
TextField.tabEnabled	Indique si un clip est inclus dans l'ordre de tabulation automatique.
TextField.tabIndex	Indique l'ordre de tabulation d'un objet.
TextField.text	Le texte du champ de texte.
TextField.textColor	La couleur du texte d'un champ de texte.
TextField.textHeight	La hauteur du cadre de délimitation du champ de texte.
TextField.textWidth	La largeur du cadre de délimitation du champ de texte.
TextField.type	Indique si un champ de texte est un champ de saisie ou un champ de texte dynamique.
TextField._url	L'URL du fichier SWF créateur de l'occurrence de champ de texte.
TextField.variable	Le nom de variable associé au champ de texte.
TextField._visible	Une valeur booléenne déterminant si l'occurrence d'un champ de texte est masquée ou visible.
TextField._width	La largeur d'une occurrence de champ de texte, en pixels. Cela n'affecte que le cadre de délimitation du champ de texte, pas l'épaisseur de la bordure ou la taille du texte.
TextField.wordWrap	Indique si le texte du champ de texte passe automatiquement à la ligne.
TextField._x	La coordonnée x d'une occurrence de champ de texte.
TextField._xmouse	La coordonnée x du curseur par rapport à une occurrence de champ de texte.
TextField._xscale	La valeur spécifiant le pourcentage de redimensionnement horizontal d'une occurrence de champ de texte.
TextField._y	La coordonnée y d'une occurrence de champ de texte.
TextField._ymouse	La coordonnée y du curseur par rapport à une occurrence de champ de texte.
TextField._yscale	La valeur spécifiant le pourcentage de redimensionnement vertical d'une occurrence de champ de texte.

 
Gestionnaires d'événement de l'objet TextField

Méthode	Description
TextField.onChanged	Invoqué lorsque le contenu du champ de texte change.
TextField.onKillFocus	Invoqué lorsqu'un champ de texte perd le focus.
TextField.onScroller	Invoqué lorsque la propriété scroll, maxscroll, hscroll, maxhscroll ou bottomscroll d'un champ de texte change.
TextField.onSetFocus	Invoqué lorsqu'un champ de texte reçoit le focus.

 
Ecouteurs de l'objet TextField

Méthode	Description
TextField.onChanged	Notifié lorsque le contenu du champ de texte change.
TextField.onScroller	Notifié lorsque la propriété scroll ou maxscroll d'un champ de texte change.