| Package | fl.controls |
| Classe | public class TextInput |
| Héritage | TextInput  UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Implémente | IFocusManagerComponent |
| Sous-classes | DataGridCellEditor |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Un composant TextInput peut être activé ou désactivé dans une application. Lorsque le composant TextInput est désactivé, il ne peut pas recevoir d’entrées de la souris ou du clavier. Tout composant TextInput activé met en œuvre le focus, la sélection et la navigation, comme tout autre objet TextField d’ActionScript.
Vous pouvez utiliser les styles pour personnaliser le composant TextInput en modifiant son aspect s’il a été désactivé, par exemple. Parmi les autres personnalisations que vous pouvez appliquer à ce composant, citons le formatage HTML ou la définition d’un champ de mot de passe qui masque le texte saisi.
Eléments de l’API associés
Propriétés publiques
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage. | DisplayObject | |
| alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | DisplayObject | |
| alwaysShowSelection : Boolean
Lit ou définit une valeur booléenne qui indique comment la sélection doit s’afficher lorsque le champ de texte n’a pas le focus. | TextInput | ||
| blendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser. | DisplayObject | |
| blendShader : Shader [écriture seule]
Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan. | DisplayObject | |
| buttonMode : Boolean
Spécifie le mode de bouton du sprite. | Sprite | |
| cacheAsBitmap : Boolean
Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur true. | DisplayObject | |
| condenseWhite : Boolean
Récupère ou définit une valeur booléenne qui indique si d’éventuels espaces blancs supplémentaires sont retirés d’un composant TextInput qui contient du texte HTML. | TextInput | ||
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| contextMenu : NativeMenu
Spécifie le menu contextuel associé à l’objet. | InteractiveObject | |
| displayAsPassword : Boolean
Récupère ou définit une valeur booléenne qui indique si l’actuelle occurrence du composant TextInput a été créée pour contenir un mot de passe ou du texte. | TextInput | ||
| doubleClickEnabled : Boolean
Spécifie si l’objet reçoit les événements doubleClick. | InteractiveObject | |
| dropTarget : DisplayObject [lecture seule]
Spécifie l’objet d’affichage sur lequel le sprite est glissé ou sur lequel il a été déposé. | Sprite | |
| editable : Boolean
Lit ou définit une valeur booléenne qui indique si le champ de texte peut être modifié par l’utilisateur. | TextInput | ||
| enabled : Boolean [override]
Récupère ou définit une valeur indiquant si le composant peut accepter une interaction de l’utilisateur. | TextInput | ||
| filters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage. | DisplayObject | |
| focusEnabled : Boolean
Récupère ou définit une valeur booléenne indiquant si le composant peut recevoir le focus après un clic de l’utilisateur sur son entrée. | UIComponent | |
| focusManager : IFocusManager
Récupère ou définit le FocusManager qui contrôle le focus pour ce composant et ses homologues. | UIComponent | |
| focusRect : Object
Spécifie si l’objet affiche un rectangle de focus. | InteractiveObject | |
| graphics : Graphics [lecture seule]
Spécifie l’objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel. | Sprite | |
| height : Number [override]
Récupère ou définit la hauteur du composant, en pixels. | UIComponent | |
| hitArea : Sprite
Désigne un autre sprite qui fera office de zone active d’un sprite. | Sprite | |
| horizontalScrollPosition : int
Lit ou définit la position du curseur sur la barre de défilement horizontale. | TextInput | ||
| htmlText : String
Contient la représentation HTML de la chaîne contenue par le champ de texte. | TextInput | ||
| imeMode : String
Lit ou définit le mode de l’éditeur de méthode d’entrée (IME). | TextInput | ||
| length : int [lecture seule]
Lit le nombre de caractères d’un composant TextInput. | TextInput | ||
| loaderInfo : LoaderInfo [lecture seule]
Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. | DisplayObject | |
| mask : DisplayObject
L’objet d’affichage appelant est masqué par l’objet mask spécifié. | DisplayObject | |
| maxChars : int
Lit ou définit le nombre maximum de caractères que l’utilisateur peut entrer dans un champ de texte. | TextInput | ||
| maxHorizontalScrollPosition : int [lecture seule]
Lit une valeur qui donne la position maximale de défilement vers la droite pour le champ de texte. | TextInput | ||
| metaData : Object
Obtient les données d’objet de métadonnées de l’occurrence DisplayObject si les données d’meta a été stockée près de la l’occurrence de cette DisplayObject dans le fichier SWF à l’aide d’une balise de4 PlaceObject. | DisplayObject | |
| mouseChildren : Boolean
Détermine si les enfants de l’objet prennent en charge la souris ou les périphériques de saisie utilisateur. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. | InteractiveObject | |
| mouseFocusEnabled : Boolean
Récupère ou définit une valeur indiquant si le composant peut recevoir le focus après un clic de l’utilisateur sur son entrée. | UIComponent | |
| mouseX : Number [lecture seule]
Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | |
| mouseY : Number [lecture seule]
Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | |
| name : String
Indique le nom d’occurrence de DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus. | InteractiveObject | |
| numChildren : int [lecture seule]
Renvoie le nombre d’enfants de l’objet. | DisplayObjectContainer | |
| opaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique. | DisplayObject | |
| parent : DisplayObjectContainer [lecture seule]
Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage. | DisplayObject | |
| restrict : String
Lit ou définit la chaîne de caractères que l’utilisateur peut entrer dans le champ de texte. | TextInput | ||
| root : DisplayObject [lecture seule]
Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier. | DisplayObject | |
| rotation : Number
Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. | DisplayObject | |
| rotationX : Number
Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | |
| rotationY : Number
Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | |
| rotationZ : Number
Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | |
| scale9Grid : Rectangle
Grille de mise à l’échelle en vigueur. | DisplayObject | |
| scaleX : Number [override]
Multiplie la largeur actuelle du composant par un facteur de redimensionnement. | UIComponent | |
| scaleY : Number [override]
Multiplie la hauteur actuelle du composant par un facteur de redimensionnement. | UIComponent | |
| scaleZ : Number
Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement. | DisplayObject | |
| scrollRect : Rectangle
Cadre de sélection du défilement de l’objet d’affichage. | DisplayObject | |
| selectionBeginIndex : int [lecture seule]
Lit l’index du premier caractère sélectionné dans une sélection d’un ou plusieurs caractères. | TextInput | ||
| selectionEndIndex : int [lecture seule]
Lit l’index du dernier caractère sélectionné dans une sélection d’un ou plusieurs caractères. | TextInput | ||
| softKeyboard : String
Contrôle l’aspect du clavier logiciel. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche (non disponible sur iOS) | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Contrôle le son à l’intérieur du sprite. | Sprite | |
| stage : Stage [lecture seule]
Scène de l’objet d’affichage. | DisplayObject | |
| tabChildren : Boolean
Détermine si les enfants de l’objet prennent ou non en charge la tabulation. | DisplayObjectContainer | |
| tabEnabled : Boolean
Indique si cet objet est spécifié dans l’ordre de tabulation. | InteractiveObject | |
| tabIndex : int
Spécifie l’ordre de tabulation des objets dans un fichier SWF. | InteractiveObject | |
| text : String
Lit ou définit une chaîne qui contient le texte qui figure actuellement dans le composant TextInput. | TextInput | ||
| textField : flash.text:TextField
Une référence au champ de texte interne du composant TextInput. | TextInput | ||
| textHeight : Number [lecture seule]
Hauteur du texte, en pixels. | TextInput | ||
| textSnapshot : flash.text:TextSnapshot [lecture seule]
Renvoie un objet TextSnapshot pour l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | |
| textWidth : Number [lecture seule]
Largeur du texte, en pixels. | TextInput | ||
| transform : flash.geom:Transform
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. | DisplayObject | |
| useHandCursor : Boolean
Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque le pointeur survole un sprite dont la propriété buttonMode est définie sur true. | Sprite | |
| visible : Boolean [override]
Récupère ou définit une valeur indiquant si l’occurrence du composant actif est visible. | UIComponent | |
| width : Number [override]
Récupère ou définit la largeur du composant, en pixels. | UIComponent | |
| x : Number [override]
Récupère ou définit la coordonnée x représentant la position du composant le long de l’axe x au sein de son conteneur parent. | UIComponent | |
| y : Number [override]
Récupère ou définit la coordonnée y représentant la position du composant le long de l’axe y au sein de son conteneur parent. | UIComponent | |
| z : Number
Indique la position de coordonnée z le long de l’axe des z de l’occurrence DisplayObject par rapport au conteneur 3D parent. | DisplayObject | |
Méthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
Crée une nouvelle occurrence du composant TextInput. | TextInput | ||
|
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. | DisplayObjectContainer | |
|
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
Ajoute la chaîne spécifiée après le dernier caractère contenu dans TextArea. | TextInput | ||
|
Indique si les restrictions de sécurité entraîneraient l’omission des objets d’affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point « point » spécifié. | DisplayObjectContainer | |
|
Définit une propriété de style depuis cette occurrence de composant. | UIComponent | |
|
Détermine si l’objet d’affichage spécifié est un enfant de l’occurrence de DisplayObjectContainer ou l’occurrence en tant que telle. | DisplayObjectContainer | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
[override]
Affiche ou masque l’indicateur de focus dans ce composant. | TextInput | ||
|
Déclenche une opération de dessin immédiate, sans tout annuler comme le fait invalidateNow. | UIComponent | |
|
Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace. | DisplayObject | |
|
Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié. | DisplayObjectContainer | |
|
Renvoie l’objet d’affichage enfant portant le nom spécifié. | DisplayObjectContainer | |
|
Renvoie la position d’index d’une occurrence enfant de DisplayObject. | DisplayObjectContainer | |
|
Récupère l’objet qui détient actuellement le focus. | UIComponent | |
Extrait des informations sur une ligne de texte spécifique. | TextInput | ||
|
Renvoie un tableau d’objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | |
|
Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes. | DisplayObject | |
|
Extrait une propriété de style définie dans la chaîne de recherche de style du composant. | UIComponent | |
[statique]
Récupère la texture de style par défaut du composant actif. | TextInput | ||
|
Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales). | DisplayObject | |
|
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales). | DisplayObject | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj. | DisplayObject | |
|
Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y. | DisplayObject | |
|
Marque une propriété comme non valide, puis redessine le composant dans la prochaine image, sauf spécification contraire. | UIComponent | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales). | DisplayObject | |
|
Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales). | DisplayObject | |
| [statique]
Fusionne les styles de plusieurs classes en un seul objet. | UIComponent | |
|
Déplace le composant à la position spécifiée dans son parent. | UIComponent | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime l’occurrence enfant de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | |
|
Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer. | DisplayObjectContainer | |
|
Supprime toutes les occurrences enfants de DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Affiche un clavier virtuel. | InteractiveObject | |
|
Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage. | DisplayObjectContainer | |
|
Définit le focus sur ce composant. | UIComponent | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
Définit l’étendue d’une sélection effectuée dans une zone de texte qui a le focus. | TextInput | ||
|
Définit le composant en fonction de la largeur et de la hauteur spécifiées. | UIComponent | |
|
Définit une propriété de style pour cette occurrence de composant. | UIComponent | |
|
Permet à l’utilisateur de faire glisser le sprite spécifié. | Sprite | |
|
Permet à l’utilisateur de faire glisser le sprite spécifié sur un périphérique tactile. | Sprite | |
|
Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine. | DisplayObjectContainer | |
|
Met fin à la méthode startDrag(). | Sprite | |
|
Met fin à la méthode startTouchDrag() en vue d’utiliser des périphériques tactiles. | Sprite | |
|
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés. | DisplayObjectContainer | |
|
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des objets enfant aux deux positions d’index spécifiées dans la liste d’enfants. | DisplayObjectContainer | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Valide et met à jour les propriétés et la mise en forme de cet objet, puis le redessine si nécessaire. | UIComponent | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
Méthodes protégées
Evénements
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage. | DisplayObject | ||
| Envoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | ||
| Distribué lorsque la saisie de l’utilisateur modifie le texte du composant TextInput. | TextInput | |||
| Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel. | InteractiveObject | ||
| Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR. | InteractiveObject | ||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel. | InteractiveObject | ||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel. | InteractiveObject | ||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsque l’utilisateur appuie sur le bouton principal d’un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d’InteractiveObject si l’indicateur doubleClickEnabled de cet objet est réglé sur true. | InteractiveObject | ||
| Distribué lorsque l’utilisateur appuie sur la touche Entrée. | TextInput | |||
| [événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image. | DisplayObject | ||
| [événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours. | DisplayObject | ||
| Distribué après la prise de focus par un objet d’affichage. | InteractiveObject | ||
| Distribué après la perte de focus par un objet d’affichage. | InteractiveObject | ||
| [événement de diffusion] Distribué après l’exécution des constructeurs des objets d’affichage d’image, mais avant celle des scripts d’image. | DisplayObject | ||
| Distribué lorsque l’utilisateur crée un point de contact le long du bord de la surface tactile à l’aide d’une occurrence InteractiveObject (par exemple, en appuyant le long du bord de la surface tactile sur la télécommande Siri Remote pour l’Apple TV). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements tactiles. | InteractiveObject | ||
| Distribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire). | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter). | InteractiveObject | ||
| Distribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu). | InteractiveObject | ||
| Distribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué après que la visibilité du composant soit passée de visible à invisible. | UIComponent | ||
| Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME. | InteractiveObject | ||
| Distribué lorsque l’utilisateur appuie sur une touche. | InteractiveObject | ||
| Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier. | InteractiveObject | ||
| Distribué lorsque l’utilisateur relâche une touche. | InteractiveObject | ||
| Distribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsque la molette d’une souris est actionnée sur une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué à la suite du déplacement du composant. | UIComponent | ||
| Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser. | InteractiveObject | ||
| Distribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop(). | InteractiveObject | ||
| Distribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites. | InteractiveObject | ||
| Distribué par un InteractiveObject lorsqu’une opération glisser sort des limites. | InteractiveObject | ||
| Distribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites. | InteractiveObject | ||
| Distribué au début d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag(). | InteractiveObject | ||
| Distribué lors d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag(). | InteractiveObject | ||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne "Coller" dans le menu contextuel. | InteractiveObject | ||
| Distribué lorsque l’utilisateur approche un stylet actif de l’écran après le seuil de détection de proximité de l’écran. | InteractiveObject | ||
| Distribué lorsque l’utilisateur soulève un stylet actif au-dessus du seuil de détection de proximité de l’écran. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un stylet actif sur l’écran tout en respectant le seuil de détection de proximité. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un stylet actif en dehors de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un stylet actif directement au-dessus de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un stylet actif hors de cet objet InteractiveObject et de l’un de ses enfants, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un stylet actif sur cet objet InteractiveObject de l’extérieur de l’arborescence d’objets de descendants dans la liste d’affichage (tout en respectant le seuil de détection de proximité de l’écran). | InteractiveObject | ||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage après avoir appuyé sur le bouton sur une occurrence d’InteractiveObject, puis après avoir déplacé le périphérique de pointage hors de l’occurrence d’InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage. | DisplayObject | ||
| Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage de la scène, directement ou par l’intermédiaire de la suppression d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | ||
| [événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée. | DisplayObject | ||
| Distribué à la suite du redimensionnement du composant. | UIComponent | ||
| Distribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit "Sélectionner tout" dans le menu contextuel. | InteractiveObject | ||
| Distribué après que la visibilité du composant soit passée de invisible à visible. | UIComponent | ||
| Distribué immédiatement après l’affichage du clavier logiciel. | InteractiveObject | ||
| Distribué immédiatement avant l’affichage du clavier logiciel. | InteractiveObject | ||
| Distribué immédiatement après la disparition du clavier logiciel. | InteractiveObject | ||
| Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change. | InteractiveObject | ||
| Distribué lorsque l’indicateur tabEnabled de l’objet change. | InteractiveObject | ||
| Distribué lorsque la valeur de la propriété tabIndex de l’objet change. | InteractiveObject | ||
| Distribué lorsque l’utilisateur saisit du texte. | TextInput | |||
| Distribué lorsque l’utilisateur touche pour la première fois un périphérique tactile (notamment lorsqu’il pose un doigt sur un téléphone portable ou une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur cesse le contact avec un périphérique tactile (notamment lorsqu’il retire le doigt d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur appuie sur le périphérique, et est continuellement distribué jusqu’au retrait du point de contact. | InteractiveObject | ||
| Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un objet d’affichage vers un autre sur un téléphone portable ou une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un se trouvant sur l’objet d’affichage d’un téléphone portable ou une tablette munis d’un écran tactile vers un point se trouvant en dehors de cet objet). | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur lève le point de contact sur la même occurrence d’InteractiveObject sur laquelle le contact a été lancé sur un périphérique tactile (notamment lorsqu’il appuie avec un doigt à partir d’un point de contact unique sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis le retire). | InteractiveObject | ||
Styles
Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.
Styles communs
| Style | Description | Défini par | ||
|---|---|---|---|---|
disabledSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme arrière-plan du composant TextInput lorsque sa propriété enabled est définie sur false.
La valeur par défaut est TextInput_disabledSkin. | TextInput | ||
| Type: flash.text.TextFormat Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Objet TextFormat à utiliser pour le rendu de l’étiquette du composant lorsque le bouton est désactivé. | UIComponent | ||
embedFonts | Type: Boolean Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Indique si des polices vectorielles incorporées sont utilisées pour le rendu du champ de texte. Si cette valeur est true, Flash Player procède au rendu du champ de texte à l’aide des polices vectorielles incorporées. Si cette valeur est false, Flash Player procède au rendu du champ de texte à l’aide des polices de périphérique.
Si vous définissez la propriété false. | TextInput | ||
| Type: Number Format: Length Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Remplissage qui sépare les limites extérieures du composant et les bords extérieurs de l’indicateur du focus, en pixels. | UIComponent | ||
| Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe à utiliser pour afficher les indicateurs de focus. | UIComponent | ||
| Type: flash.text.TextFormat Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Objet TextFormat à utiliser pour le rendu de l’étiquette du composant. | UIComponent | ||
textPadding | Type: Number Format: Length Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Remplissage qui sépare la bordure du composant et le texte, en pixels. La valeur par défaut est 0. | TextInput | ||
upSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme arrière-plan du composant TextInput. La valeur par défaut est TextInput_upSkin. | TextInput | ||
Constantes publiques
Détails de la propriété
alwaysShowSelection | propriété |
alwaysShowSelection:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit une valeur booléenne qui indique comment la sélection doit s’afficher lorsque le champ de texte n’a pas le focus.
Lorsque cette valeur est définie sur true et si le champ de texte n’a pas le focus, Flash Player sélectionne le contenu du champ de texte en gris. Lorsque cette valeur est définie sur false et si le champ de texte n’a pas le focus, Flash Player ne sélectionne pas le contenu du champ de texte.
La valeur par défaut est false.
Implémentation
public function get alwaysShowSelection():Boolean public function set alwaysShowSelection(value:Boolean):voidExemple ( Comment utiliser cet exemple )
L’exemple suivant crée un composant TextInput et sélectionne du texte à l’aide de la méthode
setSelection() :
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
condenseWhite | propriété |
condenseWhite:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère ou définit une valeur booléenne qui indique si d’éventuels espaces blancs supplémentaires sont retirés d’un composant TextInput qui contient du texte HTML. Les espaces et les sauts de ligne sont des exemples d’espace blanc supplémentaire dans le composant. La valeur true indique que les espaces blancs sont supprimés, tandis que false indique le contraire.
Cette propriété affecte uniquement le texte qui est défini à l’aide de la propriété htmlText. Le texte défini à l’aide de la propriété text n’est pas affecté. Lorsque vous utilisez la propriété text pour définir du texte, la propriété condenseWhite est ignorée.
Si vous définissez la propriété condenseWhite sur true, vous devez utiliser les commandes HTML classiques, telles que <br> et <p>, pour placer des sauts de ligne dans le champ de texte.
La valeur par défaut est false.
Implémentation
public function get condenseWhite():Boolean public function set condenseWhite(value:Boolean):voidEléments de l’API associés
displayAsPassword | propriété |
displayAsPassword:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère ou définit une valeur booléenne qui indique si l’actuelle occurrence du composant TextInput a été créée pour contenir un mot de passe ou du texte. La valeur true indique que l’occurrence de composant est un champ de texte de mot de passe, tandis que false indique qu’il s’agit d’un champ de texte normal.
Lorsque cette propriété est définie sur true, les caractères saisis par l’utilisateur sont remplacés par des astérisques dans l’occurrence du composant TextInput. En outre, les commandes Couper et Copier, ainsi que les raccourcis clavier correspondants sont désactivés. Ces mesures permettent de protéger les mots de passe contre les tentatives de vol.
La valeur par défaut est false.
Implémentation
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):voidEléments de l’API associés
Exemple ( Comment utiliser cet exemple )
L’exemple suivant crée deux occurrences du composant TextInput, l’une avec la propriété
displayAsPassword définie sur true et l’autre définie sur false :
import fl.controls.Label; import fl.controls.TextInput; var usernameLabel:Label = new Label(); usernameLabel.text = "User name:"; usernameLabel.move(10, 10); addChild(usernameLabel); var usernameTextInput:TextInput = new TextInput(); usernameTextInput.move(90, 10); addChild(usernameTextInput); var passwordLabel:Label = new Label(); passwordLabel.text = "Password:"; passwordLabel.move(10, 40); addChild(passwordLabel); var passwordTextInput:TextInput = new TextInput(); passwordTextInput.displayAsPassword = true; passwordTextInput.move(90, 40); addChild(passwordTextInput);
editable | propriété |
editable:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit une valeur booléenne qui indique si le champ de texte peut être modifié par l’utilisateur. La valeur true indique que le champ de texte peut être modifié par l’utilisateur, tandis que false indique le contraire.
La valeur par défaut est true.
Implémentation
public function get editable():Boolean public function set editable(value:Boolean):voidenabled | propriété |
enabled:Boolean[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère ou définit une valeur indiquant si le composant peut accepter une interaction de l’utilisateur. La valeur true indique que le composant peut accepter une interaction de l’utilisateur ; la valeur false indique qu’il ne le peut pas.
Si vous définissez la propriété enabled sur false, la couleur du conteneur est grisée et la saisie de l’utilisateur est bloquée (sauf pour les composants Label et ProgressBar).
Implémentation
override public function get enabled():Boolean override public function set enabled(value:Boolean):voidhorizontalScrollPosition | propriété |
horizontalScrollPosition:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit la position du curseur sur la barre de défilement horizontale.
La valeur par défaut est 0.
Implémentation
public function get horizontalScrollPosition():int public function set horizontalScrollPosition(value:int):voidEléments de l’API associés
Exemple ( Comment utiliser cet exemple )
L’exemple suivant crée une occurrence du composant TextInput et affiche la valeur actuelle de ses propriétés
horizontalScrollPosition et maxHorizontalScrollPosition :
import fl.controls.Label;
import fl.controls.Slider;
import fl.controls.TextInput;
import fl.events.SliderEvent;
var myTextInput:TextInput = new TextInput();
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.width = 120;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, textInputChangeHandler);
myTextInput.textField.addEventListener(Event.SCROLL, scrollHandler);
addChild(myTextInput);
var mySlider:Slider = new Slider();
mySlider.snapInterval = 1;
mySlider.tickInterval = 10;
mySlider.minimum = 0;
mySlider.maximum = myTextInput.maxHorizontalScrollPosition;
mySlider.value = myTextInput.horizontalScrollPosition;
mySlider.liveDragging = true;
mySlider.addEventListener(SliderEvent.CHANGE, sliderChangeHandler);
mySlider.width = 120;
mySlider.move(10, 40);
addChild(mySlider);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 50);
addChild(myLabel);
getScrollPosition();
function getScrollPosition():void {
myTextInput.drawNow();
var scrollPos:uint = myTextInput.horizontalScrollPosition;
var maxScrollPos:uint = myTextInput.maxHorizontalScrollPosition;
myLabel.text = "scrollPosition: " + scrollPos + " of " + maxScrollPos;
mySlider.value = scrollPos;
mySlider.maximum = maxScrollPos;
}
function scrollHandler(event:Event):void {
getScrollPosition();
}
function sliderChangeHandler(event:SliderEvent):void {
myTextInput.horizontalScrollPosition = event.value;
getScrollPosition();
}
function textInputChangeHandler(event:Event):void {
getScrollPosition();
}
htmlText | propriété |
htmlText:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Contient la représentation HTML de la chaîne contenue par le champ de texte.
La valeur par défaut est "".
Implémentation
public function get htmlText():String public function set htmlText(value:String):voidEléments de l’API associés
Exemple ( Comment utiliser cet exemple )
L’exemple suivant crée un composant TextInput non modifiable et définit la propriété
htmlText pour appliquer une mise en forme HTML au champ de texte :
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.editable = false; myTextInput.enabled = false; myTextInput.htmlText = "(<i>auto assigned</i>)"; myTextInput.move(10, 10); addChild(myTextInput);
imeMode | propriété |
imeMode:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit le mode de l’éditeur de méthode d’entrée (IME). L’IME permet aux utilisateur d’utiliser un clavier AZERTY pour saisir des caractères chinois, japonais ou coréens.
Flash définit l’IME sur le mode spécifié lorsque le composant obtient le focus et restaure sa valeur d’origine lorsque ce composant perd le focus.
La classe flash.system.IMEConversionMode définit des constantes pour les valeurs possibles de cette propriété. Définissez cette propriété sur null pour empêcher l’utilisation de l’éditeur IME avec le composant.
Implémentation
public function get imeMode():String public function set imeMode(value:String):voidlength | propriété |
length:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit le nombre de caractères d’un composant TextInput.
La valeur par défaut est 0.
Implémentation
public function get length():intEléments de l’API associés
Exemple ( Comment utiliser cet exemple )
L’exemple suivant crée un composant TextInput et définit ses propriétés
maxChars et restrict pour limiter les caractères pouvant être saisis :
import fl.controls.Label;
import fl.controls.TextInput;
var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "0-9A-F";
myTextInput.maxChars = 6;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
myLabel.move(10, 30);
addChild(myLabel);
function changeHandler(event:Event):void {
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
}
maxChars | propriété |
maxChars:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit le nombre maximum de caractères que l’utilisateur peut entrer dans un champ de texte.
La valeur par défaut est 0.
Implémentation
public function get maxChars():int public function set maxChars(value:int):voidEléments de l’API associés
Exemple ( Comment utiliser cet exemple )
L’exemple suivant crée un composant TextInput et définit ses propriétés
maxChars et restrict pour limiter les caractères pouvant être saisis :
import fl.controls.Label;
import fl.controls.TextInput;
var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "0-9A-F";
myTextInput.maxChars = 6;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
myLabel.move(10, 30);
addChild(myLabel);
function changeHandler(event:Event):void {
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
}
maxHorizontalScrollPosition | propriété |
maxHorizontalScrollPosition:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit une valeur qui donne la position maximale de défilement vers la droite pour le champ de texte.
La valeur par défaut est 0.
Implémentation
public function get maxHorizontalScrollPosition():intEléments de l’API associés
restrict | propriété |
restrict:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit la chaîne de caractères que l’utilisateur peut entrer dans le champ de texte. Tenez compte du fait que les caractères qui ne sont pas inclus dans cette chaîne ne sont acceptés dans le champ de texte que s’ils sont entrés par le programme.
Les caractères de la chaîne sont lus de gauche à droite. Vous pouvez spécifier une plage de caractères à l’aide d’un tiret (-).
Lorsque la valeur de cette propriété est null, le champ de texte accepte tous les caractères. Lorsque cette propriété est définie sur une chaîne vide (""), le champ de texte n’accepte aucun caractère.
Si la chaîne commence par un caret (^), tous les caractères sont initialement acceptés et les caractères suivants de la chaîne sont exclus du jeu de caractères acceptés. Si la chaîne ne commence pas par un caret (^), aucun caractère n’est initialement accepté et les caractères suivants de la chaîne sont inclus dans le jeu de caractères acceptés.
La valeur par défaut est null.
Implémentation
public function get restrict():String public function set restrict(value:String):voidEléments de l’API associés
selectionBeginIndex | propriété |
selectionBeginIndex:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit l’index du premier caractère sélectionné dans une sélection d’un ou plusieurs caractères.
La position d’index du caractère sélectionné est de base zéro et est calculée à partir du premier caractère qui s’affiche dans la zone de texte. En l’absence de sélection, cette valeur est définie sur la position du caractère circonflexe.
La valeur par défaut est 0.
Implémentation
public function get selectionBeginIndex():intEléments de l’API associés
Exemple ( Comment utiliser cet exemple )
L’exemple suivant crée un composant Label qui affiche les propriétés
selectionBeginIndex et selectionEndIndex d’un composant TextInput. Cet exemple crée également deux occurrences du composant Slider pouvant être utilisées pour définir par programmation les index de début et de fin de la sélection à l’aide de la méthode setSelection() :
import fl.controls.Label;
import fl.controls.Slider;
import fl.controls.TextInput;
import fl.events.SliderEvent;
var myTextInput:TextInput = new TextInput();
myTextInput.alwaysShowSelection = true;
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.width = 120;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
myTextInput.addEventListener(FocusEvent.FOCUS_IN, focusInHandler);
myTextInput.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler);
addChild(myTextInput);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 30);
addChild(myLabel);
var beginSlider:Slider = new Slider();
beginSlider.maximum = myTextInput.length;
beginSlider.snapInterval = 1;
beginSlider.liveDragging = true;
beginSlider.width = 120;
beginSlider.move(10, 65);
beginSlider.addEventListener(SliderEvent.CHANGE, beginChangeHandler);
addChild(beginSlider);
var endSlider:Slider = new Slider();
endSlider.maximum = myTextInput.length;
endSlider.snapInterval = 1;
endSlider.liveDragging = true;
endSlider.width = 120;
endSlider.move(10, 85);
endSlider.addEventListener(SliderEvent.CHANGE, endChangeHandler);
addChild(endSlider);
var t:Timer = new Timer(50);
t.addEventListener(TimerEvent.TIMER, timerHandler);
function changeHandler(event:Event):void {
beginSlider.maximum = myTextInput.length;
endSlider.maximum = myTextInput.length;
updateUI();
}
function focusInHandler(event:FocusEvent):void {
t.start();
}
function focusOutHandler(event:FocusEvent):void {
t.stop();
}
function beginChangeHandler(event:SliderEvent):void {
myTextInput.setSelection(event.value, myTextInput.selectionEndIndex);
updateUI();
}
function endChangeHandler(event:SliderEvent):void {
myTextInput.setSelection(myTextInput.selectionBeginIndex, event.value);
updateUI();
}
function timerHandler(event:TimerEvent):void {
updateUI();
}
function updateUI():void {
myLabel.text = "selectionBeginIndex:" + myTextInput.selectionBeginIndex + "\n";
myLabel.text += "selectionEndIndex:" + myTextInput.selectionEndIndex;
beginSlider.value = myTextInput.selectionBeginIndex;
endSlider.value = myTextInput.selectionEndIndex;
}
selectionEndIndex | propriété |
selectionEndIndex:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit l’index du dernier caractère sélectionné dans une sélection d’un ou plusieurs caractères.
La position d’index du caractère sélectionné est de base zéro et est calculée à partir du premier caractère qui s’affiche dans la zone de texte. En l’absence de sélection, cette valeur est définie sur la position du caractère circonflexe.
La valeur par défaut est 0.
Implémentation
public function get selectionEndIndex():intEléments de l’API associés
text | propriété |
text:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Lit ou définit une chaîne qui contient le texte qui figure actuellement dans le composant TextInput. Cette propriété contient du texte qui n’est pas formaté et n’a donc pas de balises HTML. Pour extraire le texte au format HTML, utilisez la propriété htmlText.
La valeur par défaut est "".
Implémentation
public function get text():String public function set text(value:String):voidEléments de l’API associés
textField | propriété |
public var textField:flash.text:TextField| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Une référence au champ de texte interne du composant TextInput.
Exemple ( Comment utiliser cet exemple )
L’exemple suivant crée une occurrence du composant TextInput et utilise la propriété
textField pour accéder à l’objet natif ActionScript TextField sous-jacent et appeler sa méthode replaceText() :
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.textField.replaceText(41, 44, "fox"); myTextInput.textField.replaceText(16, 19, "dog"); addChild(myTextInput);
textHeight | propriété |
textWidth | propriété |
textWidth:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Largeur du texte, en pixels.
La valeur par défaut est 0.
Implémentation
public function get textWidth():NumberEléments de l’API associés
Exemple ( Comment utiliser cet exemple )
L’exemple suivant crée une occurrence du composant TextInput et recherche les propriétés
textWidth et textHeight à chaque modification du contenu du champ de texte :
import fl.controls.TextInput;
var myTextInput:TextInput = new TextInput();
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);
function changeHandler(event:Event):void {
trace("textWidth:" + myTextInput.textWidth + ", textHeight:" + myTextInput.textHeight);
}
Détails du constructeur
TextInput | () | Constructeur |
public function TextInput()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Crée une nouvelle occurrence du composant TextInput.
Détails de la méthode
appendText | () | méthode |
public function appendText(text:String):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Ajoute la chaîne spécifiée après le dernier caractère contenu dans TextArea. Cette méthode est plus efficace que la concaténation de deux chaînes à l’aide d’une affectation d’addition sur une propriété de texte, par exemple, myTextArea.text += moreText. Cette méthode est particulièrement utile lorsque le contenu du composant TextArea est significatif.
Paramètres
text:String — Chaîne à ajouter au texte existant.
|
drawFocus | () | méthode |
override public function drawFocus(draw:Boolean):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Affiche ou masque l’indicateur de focus dans ce composant.
La classe UIComponent implémente cette méthode en créant et en positionnant une occurrence de la classe spécifiée par le style focusSkin.
Paramètres
draw:Boolean — Signale si l’indicateur de focus est affiché ou masqué. Si cette valeur est true, l’indicateur de focus s’affiche ; si elle est false, il est masqué.
|
getLineMetrics | () | méthode |
public function getLineMetrics(index:int):flash.text:TextLineMetrics| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Extrait des informations sur une ligne de texte spécifique.
Paramètres
index:int — Le numéro de la ligne pour laquelle des informations doivent être extraites.
|
flash.text:TextLineMetrics |
Exemple ( Comment utiliser cet exemple )
L’exemple suivant dessine un rectangle rouge dont la partie supérieure correspond à la hauteur des lettres ascendantes et la partie inférieure à leur jambage :
var format:TextFormat = new TextFormat();
format.size = 72;
format.font = "Georgia";
import fl.controls.TextInput;
var ti:TextInput = new TextInput();
addChild(ti);
ti.setSize(393,82);
ti.move(10,10);
ti.setStyle("textFormat",format);
ti.text = "Hello World";
ti.drawNow();
var metrics:TextLineMetrics = ti.getLineMetrics(0);
var ascenderColoring:Shape = new Shape();
var descenderColoring:Shape = new Shape();
ti.addChild(ascenderColoring);
ti.addChild(descenderColoring);
ascenderColoring.graphics.clear();
ascenderColoring.graphics.beginFill(0xFF0000,0.2);
ascenderColoring.graphics.drawRect(0, 0, metrics.width, metrics.ascent);
descenderColoring.graphics.clear();
descenderColoring.graphics.beginFill(0x0000FF,0.2);
descenderColoring.graphics.drawRect(0, metrics.ascent + 2, metrics.width, metrics.descent);
getStyleDefinition | () | méthode |
public static function getStyleDefinition():Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère la texture de style par défaut du composant actif. La texture de style contient le type adapté au composant, qui dépend du style utilisé par ce dernier. Par exemple, le style disabledTextFormat contient la valeur null ou un objet TextFormat. Vous pouvez utiliser ces styles et appeler setStyle() pour le composant actif. Le code suivant ignore le style par défaut disabledTextFormat dans le composant spécifié :
componentInstance.setStyle("disabledTextFormat", new TextFormat());Object — Objet de styles par défaut.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
L’exemple suivant crée un navigateur de styles pour différentes classes de composant :
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;
var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } );
dp.addItem( { label: "Button", data:Button } );
dp.addItem( { label: "CellRenderer", data:CellRenderer } );
dp.addItem( { label: "CheckBox", data:CheckBox } );
dp.addItem( { label: "ColorPicker", data:ColorPicker } );
dp.addItem( { label: "ComboBox", data:ComboBox } );
dp.addItem( { label: "DataGrid", data:DataGrid } );
dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } );
dp.addItem( { label: "ImageCell", data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label", data:Label } );
dp.addItem( { label: "List", data:List } );
dp.addItem( { label: "NumericStepper", data:NumericStepper } );
dp.addItem( { label: "ProgressBar", data:ProgressBar } );
dp.addItem( { label: "RadioButton", data:RadioButton } );
dp.addItem( { label: "ScrollPane", data:ScrollPane } );
dp.addItem( { label: "Slider", data:Slider } );
dp.addItem( { label: "TextArea", data:TextArea } );
dp.addItem( { label: "TextInput", data:TextInput } );
dp.addItem( { label: "TileList", data:TileList } );
dp.addItem( { label: "UILoader", data:UILoader } );
dp.addItem( { label: "UIComponent", data:UIComponent } );
var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);
var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);
function showStyleDefinition(e:Event):void {
var componentClass:Class = e.target.selectedItem.data as Class;
var styles:Object = componentClass["getStyleDefinition"].call(this);
trace(styles.toString());
var styleData:DataProvider = new DataProvider();
for(var i:* in styles) {
trace(i + " : " + styles[i]);
styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
}
styleData.sortOn("StyleName");
dg.dataProvider = styleData;
}
setSelection | () | méthode |
public function setSelection(beginIndex:int, endIndex:int):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Définit l’étendue d’une sélection effectuée dans une zone de texte qui a le focus. La plage de sélection commence à l’index spécifié par le paramètre de début et se termine à la position spécifiée par le paramètre de fin. Si les valeurs des paramètres qui spécifient les plages de sélection sont identiques, cette méthode définit le point d’insertion du texte de la même façon que la propriété caretIndex.
Le texte sélectionné est traité en tant que chaîne de base zéro où le premier caractère est à l’index 0, le deuxième à l’index 1, etc.
Cette méthode est sans effet lorsque le champ de texte n’a pas le focus.
Paramètres
beginIndex:int — Index du premier caractère de la sélection.
| |
endIndex:int — Indice du dernier caractère de la sélection.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
L’exemple suivant entre du texte dans une occurrence de TextInput et définit la sélection sur le second mot :
import fl.controls.TextInput; var ti:TextInput = new TextInput(); addChild(ti); ti.text = "Hello World"; ti.setFocus(); ti.setSelection(6, 11);
L’exemple suivant crée un composant TextInput et sélectionne du texte à l’aide de la méthode
setSelection() :
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
Détails de l’événement
change | Evénement |
Type d’objet d’événement:
propriété Event.type =
flash.events.Eventpropriété Event.type =
flash.events.Event.CHANGE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Distribué lorsque la saisie de l’utilisateur modifie le texte du composant TextInput.
Remarque : cet événement ne se produit pas si vous utilisez du code ActionScript pour modifier le texte.
La constante Event.CHANGE définit la valeur de la propriété type de l’objet d’événement change.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet dont la valeur a été modifiée. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement. |
enter | Evénement |
Type d’objet d’événement:
propriété ComponentEvent.type =
fl.events.ComponentEventpropriété ComponentEvent.type =
fl.events.ComponentEvent.ENTER| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Distribué lorsque l’utilisateur appuie sur la touche Entrée.
Définit la valeur de la propriététype d’un objet de l’événement enter.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
textInput | Evénement |
Type d’objet d’événement:
propriété TextEvent.type =
flash.events.TextEventpropriété TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Distribué lorsque l’utilisateur saisit du texte.
Définit la valeur de la propriététype d’un objet événement textInput.
Remarque : cet événement n’est pas distribué pour les touches Supprimer ou Retour arrière.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | true ; appelez la méthode preventDefault() pour annuler le comportement par défaut. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Champ de texte dans lequel sont entrés des caractères. La cible ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement. |
text | Caractère ou série de caractères entré par l’utilisateur. |
Exemples Comment utiliser cet exemple
TextInputExample.as
Cet exemple montre comment créer un système de connexion simple avec la classe TextInput.
- Ajoutez les composants TextInput, Label et Button dans votre bibliothèque.
- Enregistrez ce code sous le nom TextInputExample.as dans le même répertoire que votre fichier FLA.
- Dans le fichier FLA, définissez DocumentClass sur TextInputExample.
package
{
import flash.display.Sprite;
import flash.events.MouseEvent;
import flash.events.Event;
import fl.controls.TextInput;
import fl.controls.Label;
import fl.controls.Button;
public class TextInputExample extends Sprite
{
private var ti1:TextInput;
private var ti2:TextInput;
private var label1:Label;
private var label2:Label;
private var submitBtn:Button;
public function TextInputExample() {
setupLabels();
setupInputFields();
setupButton();
}
private function setupInputFields():void {
ti1 = new TextInput();
ti2 = new TextInput();
ti1.move(50,10);
ti2.move(50,40);
ti2.displayAsPassword = true;
ti1.addEventListener(Event.CHANGE, textEntered);
ti2.addEventListener(Event.CHANGE, textEntered);
addChild(ti1);
addChild(ti2);
}
private function setupLabels():void {
label1 = new Label();
label2 = new Label();
label1.move(10,10);
label2.move(10,40);
label1.text = "User:";
label2.text = "Pass:"
addChild(label1);
addChild(label2);
}
private function setupButton():void {
submitBtn = new Button();
submitBtn.move(150,70);
submitBtn.label = "Go";
submitBtn.enabled = false;
submitBtn.setSize(50,20);
submitBtn.addEventListener(MouseEvent.CLICK, submitLogin);
addChild(submitBtn);
}
private function textEntered(e:Event):void {
if(ti1.text != "" && ti2.text != "") {
submitBtn.enabled = true;
}
else {
submitBtn.enabled = false;
}
}
private function submitLogin(e:MouseEvent):void {
var submitLabel:Label = new Label();
submitLabel.move(10,70);
submitLabel.autoSize = "left";
submitLabel.text = "Login has been submitted."
addChild(submitLabel);
submitBtn.removeEventListener(MouseEvent.CLICK, submitLogin);
}
}
}
Tue Jun 12 2018, 09:30 AM Z