Flash Lite 2

Guide de référence du langage ActionScript Flash Lite 2.x > Classes ActionScript > TextField

TextField


Object
    |
    +-TextField

public dynamic class TextField
extends Object

La classe TextField permet de créer des zones d'affichage et d'entrée du texte. Tous les champs texte de saisie et dynamique dans un fichier SWF sont des occurrences de la classe TextField. Vous pouvez donner un nom d'occurrence à un champ texte dans l'inspecteur Propriétés, puis utiliser les méthodes et les propriétés de la classe TextField pour la modifier avec ActionScript. Les noms d'occurrence de TextField s'affichent dans l'explorateur d'animations et dans la boîte de dialogue Insérer un chemin cible du panneau Actions.

Pour créer dynamiquement un champ texte, vous ne devez pas utiliser l'opérateurnew. Utilisez plutôt MovieClip.createTextField() à sa place.

Les méthodes de la classe TextField permettent de définir, sélectionner et manipuler du texte dans un champ texte dynamique ou de saisie que vous créez en cours de programmation ou à l'exécution.

ActionScript offre différentes manières de formater vos textes à l'exécution. La classe TextFormat permet de définir le formatage des caractères et des paragraphes pour les objets TextField. A partir de Flash Player 7, vous pouvez appliquer des styles CSS (feuilles de style en cascade) aux champs texte à l'aide de la propriété TextField.StyleSheet et de la classe StyleSheet. Vous pouvez utiliser le style CSS pour l'appliquer aux balises HTML intégrées, définir de nouvelles balises de format ou appliquer des styles. Vous pouvez directement affecter du texte au format HTML, pouvant éventuellement utiliser des styles CSS, à un champ texte. Dans Flash Player 7 et les versions ultérieures, le texte HTML que vous assignez à un champ texte peut contenir des supports intégrés (clips vidéo, fichiers SWF, JPEG, GIF et PNG). Le texte entoure le média intégré comme dans un document HTML dans un navigateur Web.

Flash Player prend en charge un sous-ensemble de balises HTML à utiliser pour formater le texte.

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0

Voir aussi

Object, createTextField (méthode MovieClip.createTextField)

Résumé des propriétés

Modificateurs	Propriété	Description
	_alpha`:`Number	Définit ou extrait la valeur de transparence alpha du champ texte.
	autoSize`:`Object	Commande le dimensionnement et l'alignement automatiques des champs texte.
	background`:`Boolean	Spécifie si le champ texte a un remplissage d'arrière-plan.
	backgroundColor`:`Number	Couleur de l'arrière-plan du champ texte.
	border`:`Boolean	Spécifie si le champ texte comporte une bordure.
	borderColor`:`Number	Couleur de la bordure du champ texte.
	bottomScroll`:`Number [lecture seule]	Entier (index de base un) qui indique la ligne la plus basse visible dans le champ texte.
	condenseWhite`:`Boolean	Valeur booléenne qui spécifie si les espaces blancs (espaces, sauts de ligne, etc.) dans un champ texte HTML doivent être supprimés lorsque le champ est restitué dans un navigateur.
	embedFonts`:`Boolean	Valeur booléenne qui indique si le rendu du texte doit se faire à l'aide des polices vectorielles intégrées.
	_height`:`Number	Hauteur du champ texte, en pixels.
	_highquality`:`Number	Déconseillé depuis Flash Player 7. Cette propriété a été déconseillée en faveur de `TextField._quality`. Spécifie le niveau d'anti-aliasing appliqué au fichier SWF actuel.
	hscroll`:`Number	Indique la position de défilement horizontal actuelle.
	html`:`Boolean	Indicateur qui signale si le champ texte contient une représentation HTML.
	htmlText`:`String	Si le champ texte est un champ texte HTML, cette propriété contient la représentation HTML du contenu du champ texte.
	length`:`Number [lecture seule]	Indique le nombre de caractères d'un champ texte.
	maxChars`:`Number	Indique le nombre maximum de caractères qu'un champ texte peut contenir.
	maxhscroll`:`Number [lecture seule]	Indique la valeur maximale de `TextField.hscroll`.
	maxscroll`:`Number [lecture seule]	Indique la valeur maximale de `TextField.scroll`.
	multiline`:`Boolean	Indique si le champ texte est un champ texte multiligne.
	_name`:`String	Le nom de l'occurrence du champ texte.
	_parent`:`MovieClip	Référence au clip ou à l'objet contenant le champ texte ou l'objet actuel.
	password`:`Boolean	Indique si le champ texte est un champ texte de mot de passe.
	_quality`:`String	Propriété (globale) ; définit ou récupère la qualité de rendu utilisée pour un fichier SWF.
	_rotation`:`Number	Rotation du champ texte, en degrés, à partir de son orientation d'origine.
	scroll`:`Number	Définit la position verticale du texte dans un champ texte.
	selectable`:`Boolean	Valeur booléenne indiquant si le champ texte est sélectionnable.
	_soundbuftime`:`Number	Spécifie le nombre de secondes pendant lequel les sons sont chargés en mémoire tampon avant d'être diffusés en continu.
	styleSheet`:`StyleSheet	Associe une feuille de style au champ texte.
	tabEnabled`:`Boolean	Spécifie si le champ texte est inclus dans l'ordre de tabulation automatique.
	tabIndex`:`Number	Permet de personnaliser l'ordre de tabulation des objets dans un fichier SWF.
	_target`:`String [lecture seule]	Le chemin cible de l'occurrence du champ texte.
	text`:`String	Indique le texte actuel dans le champ texte.
	textColor`:`Number	Indique la couleur du texte dans un champ texte.
	textHeight`:`Number	Indique la hauteur du texte.
	textWidth`:`Number	Indique la largeur du texte.
	type`:`String	Spécifie le type de champ texte.
	_url`:`String [lecture seule]	Récupère l'URL du fichier SWF qui a créé le champ texte.
	variable`:`String	Nom de la variable à laquelle le champ texte est associé.
	_visible`:`Boolean	Valeur booléenne indiquant si le champ texte my_txt est visible.
	_width`:`Number	Largeur du champ texte, en pixels.
	wordWrap`:`Boolean	Valeur booléenne indiquant si le champ texte comporte un retour à la ligne.
	_x`:`Number	Entier qui définit la coordonnée x d'un champ texte par rapport aux coordonnées locales du clip parent.
	_xmouse`:`Number [lecture seule]	Renvoie la coordonnée x de la position de la souris par rapport au champ texte.
	_xscale`:`Number	Détermine le redimensionnement horizontal du champ texte tel qu'il est appliqué à partir du point d'alignement du champ texte, exprimé en pourcentage.
	_y`:`Number	Coordonnée y d'un champ texte par rapport aux coordonnées locales du clip parent.
	_ymouse`:`Number [lecture seule]	Indique la coordonnée y de la position de la souris par rapport au champ texte.
	_yscale`:`Number	Redimensionnement vertical du champ texte tel qu'il est appliqué à partir du point d'alignement du champ texte, exprimé en pourcentage.

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

constructor (propriété Object.constructor), __proto__ (propriété Object.__proto__), prototype (propriété Object.prototype), __resolve (propriété Object.__resolve)

Résumé des événements

Evénement	Description
onChanged `= function(changedField:`TextField`) {}`	Gestionnaire d'événements/écouteur : appelé lorsque le contenu d'un champ texte est modifié.
onKillFocus `= function(newFocus:`Object`) {}`	Appelé lorsqu'un champ texte perd le focus clavier.
onScroller `= function(scrolledField:`TextField`) {}`	Gestionnaire d'événements/écouteur : appelé lorsque l'une des propriétés de défilement du champ texte est modifiée.
onSetFocus `= function(oldFocus:`Object`) {}`	Appelé lorsqu'un champ texte reçoit le focus clavier.

Résumé de la méthode

Modificateurs	Signature	Description
	addListener`(listener:`Object`) :` Boolean	Enregistre un objet pour recevoir les notifications d'événement TextField.
	getDepth`() :` Number	Renvoie la profondeur d'un champ texte.
	getNewTextFormat`() :` TextFormat	Renvoie un objet TextFormat contenant une copie de l'objet TextFormat du champ texte.
	getTextFormat`([beginIndex:`Number`], [endIndex:`Number`]) :` TextFormat	Renvoie un objet TextFormat pour un caractère, une plage de caractères ou l'ensemble d'un objet TextField.
	removeListener`(listener:`Object`) :` Boolean	Supprime un objet écouteur précédemment enregistré dans une occurrence de champ texte avec `TextField.addListener()`.
	removeTextField`() :` Void	Supprime le champ texte.
	replaceText`(beginIndex:`Number`, endIndex:`Number`, newText:`String`) :` Void	Remplace une plage de caractères, spécifiée par les paramètres `beginIndex` et `endIndex` dans le champ texte spécifié, par le contenu du paramètre `newText`.
	setNewTextFormat`(tf:`TextFormat`) :` Void	Définit le format par défaut du nouveau texte dans un champ texte.
	setTextFormat`([beginIndex:`Number`], [endIndex:`Number`], textFormat:`TextFormat`) :` Void	Applique la mise en forme du texte spécifié par le paramètre `textFormat` à une partie ou à l'ensemble du texte dans un champ texte.

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

addProperty (méthode Object.addProperty), hasOwnProperty (méthode Object.hasOwnProperty), isPropertyEnumerable (méthode Object.isPropertyEnumerable), isPrototypeOf (méthode Object.isPrototypeOf), registerClass (méthode Object.registerClass), toString (méthode Object.toString), unwatch (méthode Object.unwatch), valueOf (méthode Object.valueOf), watch (méthode Object.watch)