documentation flash textfield

Vous êtes ici: Les articles techniques » documentation » Eléments du langage ActionScript » TextField

Table des matières

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 des 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 Player 6

Voir également

Résumé des propriétés

Modificateurs Propriété Description
_alpha:Number Définit ou extrait la valeur de transparence alpha du champ texte.
antiAliasType:String Le type d’anti-aliasing appliqué à cette instance de TextField.
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 Spécifie si le rendu doit utiliser des polices vectorielles incorporées.
filters:Array Un tableau indexé contenant tous les objets filtre associés au champ texte.
gridFitType:String Le type d’adaptation à la grille appliqué à cette occurrence de TextField.
_height:Number Hauteur du champ texte, en pixels.
_highquality:Number Déconseillé à partir de Flash Player 7. Cette propriété est déconseillée, préférez-lui 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.
menu:ContextMenu Associe l’objet ContextMenu contextMenu au champ texte my_txt.
mouseWheelEnabled:Boolean Valeur booléenne qui indique si Flash Player doit automatiquement faire défiler des champs texte multiligne lorsque le pointeur de la souris clique sur un champ texte et l’utilisateur actionne la molette.
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 La qualité de rendu utilisée pour un fichier SWF.
restrict:String Indique le jeu de caractères qu’un utilisateur peut rentrer dans le champ texte.
_rotation:Number Rotation du champ texte, en degrés, à partir de son orientation d’origine.
scroll:Number La position verticale du texte dans un champ texte.
selectable:Boolean Valeur booléenne indiquant si le champ texte est sélectionnable.
sharpness:Number La netteté des bords du glyphe dans cette occurrence TextField.
_soundbuftime:Number 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.
thickness:Number L’épaisseur des bords du glyphe dans cette occurrence TextField.
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

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.
static getFontList() : Array Renvoie les noms des polices sur le système hôte du lecteur sous forme de tableau.
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.
replaceSel(newText:String) : Void Remplace la sélection actuelle par le contenu du paramètre newText.
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




veille
inscrits inscrits ! Compensation à la rédaction
  • Inscription au wiki
  • Connexion

vod