IUITextField  - AS3 Flex

Lorsque défini 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 défini 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.

Type d’anticrènelage appliqué à ce champ de texte. Utilisez les constantes flash.text.AntiAliasType pour cette propriété. Vous ne pouvez contrôler cette définition que si la police est intégrée (avec la propriété embedFonts définie sur true). Le paramètre par défaut est flash.text.AntiAliasType.NORMAL.

Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :

Commande le dimensionnement et l’alignement automatiques des champs de texte. Les valeurs acceptables pour les constantes TextFieldAutoSize sont : TextFieldAutoSize.NONE (par défaut), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT et TextFieldAutoSize.CENTER.

Si autoSize est défini sur TextFieldAutoSize.NONE (par défaut), aucun redimensionnement n’a lieu.

Si autoSize est défini sur TextFieldAutoSize.LEFT, le texte est alors traité comme du texte cadré à gauche, ce qui signifie que la marge gauche du champ de texte reste fixe et tout redimensionnement d’un champ de texte sur une seule ligne se fera dans la marge de droite. Si le texte contient un saut de ligne (par exemple "\n" ou "\r") le bas est alors également redimensionné pour s’adapter à la ligne suivante du texte. Si wordWrap est également défini sur true, seul le bas du champ de texte est redimensionné et le côté droit reste fixe.

Si autoSize est défini sur TextFieldAutoSize.RIGHT, le texte est alors traité comme du texte cadré à droite, ce qui signifie que la marge droite du champ de texte reste fixe et tout redimensionnement d’un champ de texte sur une seule ligne se fera dans la marge de gauche. Si le texte contient un saut de ligne (par exemple "\n" ou "\r") le bas est alors également redimensionné pour s’adapter à la ligne suivante du texte. Si wordWrap est également défini sur true, seul le bas du champ de texte est redimensionné et le côté gauche reste fixe.

Si autoSize est défini sur TextFieldAutoSize.CENTER, le texte est traité comme du texte centré, ce qui signifie que tout redimensionnement d’un champ de texte sur une seule ligne est uniformément réparti sur les marges droite et gauche. Si le texte contient un saut de ligne (par exemple "\n" ou "\r") le bas est alors également redimensionné pour s’adapter à la ligne suivante du texte. Si wordWrap est également défini sur true, seul le bas du champ de texte est redimensionné et les côtés gauche et droit restent fixe.

Spécifie si le champ de texte a un remplissage d’arrière-plan. Si true, le champ de texte a un remplissage d’arrière-plan. Si false, le champ de texte n’a pas de remplissage d’arrière-plan. La propriété backgroundColor permet de définir la couleur d’arrière-plan d’un champ de texte.

Couleur de l’arrière-plan du champ de texte. La valeur par défaut est 0xFFFFFF (blanc). Cette propriété peut être extraite ou définie, même s’il n’y a pas encore d’arrière-plan, mais la couleur n’est visible que si la propriété background du champ de texte est définie sur true.

Spécifie si le champ de texte comporte une bordure. Si true, le champ de texte comporte une bordure. Si false, le champ de texte ne comporte pas de bordure. La propriété borderColor permet de définir la couleur de la bordure.

Couleur de la bordure du champ de texte. La valeur par défaut est 0x000000 (noir). Cette propriété peut être extraite ou définie, même s’il n’y a pas encore de bordure, mais la couleur n’est visible que si la propriété border du champ de texte est définie sur true.

Entier (index basé sur 1) qui indique la ligne la plus basse visible dans le champ de texte spécifié. Considérez le champ de texte comme une fenêtre sur un bloc de texte. La propriété scrollV est l’index basé sur 1 de la ligne la plus haute et visible dans la fenêtre.

Tout le texte situé entre les lignes désignées par scrollV et bottomScrollV est visible dans le champ de texte.

L’index de la position du point d’insertion (caret). Si aucun point d’insertion ne s’affiche, cette valeur correspond à la position du point d’insertion en cas de restauration du focus sur le champ (il s’agit généralement du dernier emplacement du point d’insertion, ou 0 si le champ n’a pas eu le focus).

Les index de plages de sélection sont de base zéro (par exemple, la première position est 0, la deuxième position est 1, etc.).

Valeur booléenne qui indique si l’espace blanc supplémentaire (espaces, saut de ligne, etc.) est supprimé dans un champ de texte HTML. La valeur par défaut est false. La propriété condenseWhite n’affecte que le texte défini avec la propriété htmlText, pas la propriété text. Si vous définissez du texte avec la propriété text, la propriété condenseWhite est ignorée.

Si la propriété condenseWhite est définie sur true, utilisez les commandes HTML classiques, telles que <BR> et <P>, pour placer des sauts de ligne dans le champ de texte.

Définissez la propriété condenseWhite avant de définir la propriété htmlText.

Spécifie le format appliqué au texte qui vient d’être inséré, notamment au texte saisi par un utilisateur ou inséré à l’aide de la méthode replaceSelectedText().

Remarque : lorsque vous sélectionnez des caractères en vue de les remplacer à l’aide des méthodes setSelection() et replaceSelectedText(), la propriété defaultTextFormat est appliquée uniquement si la totalité du texte (y compris le dernier caractère) a été sélectionnée. Voici un exemple :

     var my_txt:TextField new TextField();
     my_txt.text = "Flash Macintosh version";
     var my_fmt:TextFormat = new TextFormat();
     my_fmt.color = 0xFF0000;
     my_txt.defaultTextFormat = my_fmt;
     my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied
     my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied
     my_txt.replaceSelectedText("Windows version");
     

Lorsque vous accédez à la propriété defaultTextFormat, l’objet TextFormat renvoyé voit toutes ses propriétés définies. Aucune propriété n’a la valeur null.

Remarque : vous ne pouvez pas définir cette propriété lorsqu’une feuille de style est appliquée au champ de texte.

Indique si le champ de texte est un champ de texte de mot de passe. Si la valeur de cette propriété est true, le champ de texte est traité en tant que mot de passe et masque les caractères d’entrée en utilisant les astérisques à la place des caractères. Si false, le champ de texte n’est pas traité comme un mot de passe. Lorsque le mode mot de passe est activé, les commandes Couper et Copier et leurs raccourcis clavier ne fonctionnent pas. Ce mécanisme de sécurité empêche un utilisateur malhonnête d’utiliser les raccourcis pour découvrir le mot de passe d’un ordinateur sans surveillance.

Spécifie si l’objet reçoit les événements doubleClick. La valeur par défaut est false, ce qui signifie que, par défaut, une occurrence d’InteractiveObject ne reçoit pas les événements doubleClick. Si la propriété doubleClickEnabled est réglée sur true, l’occurrence reçoit les événements doubleClick qui la concernent. La propriété mouseEnabled de l’occurrence d’InteractiveObject doit également être réglée sur true pour que l’objet reçoive les événements doubleClick.

Définir cette propriété ne distribue aucun événement. Vous devez utiliser la méthode addEventListener() pour ajouter un écouteur d’événement à l’événement doubleClick.

Spécifie si le rendu doit utiliser des polices vectorielles incorporées. Si false, Flash Player restitue le champ de texte à l’aide de polices de périphérique.

Si vous définissez la propriété embedFonts sur true pour un champ de texte, vous devez spécifier la police du texte par l’intermédiaire de la propriété font d’un objet TextFormat appliqué au champ de texte. Si la police spécifiée n’est pas intégrée dans le fichier SWF, le texte ne s’affiche pas.

Spécifie si l’objet affiche un rectangle de focus. Trois valeurs sont possibles : true, false ou null. Les valeurs true et false fonctionnent comme prévu, c’est-à-dire indiquent si le rectangle du focus s’affiche. La valeur null indique que cet objet dépend de la propriété stageFocusRect de la scène.

Type d’adaptation à la grille appliqué à ce champ de texte. Cette propriété s’applique uniquement si la propriété flash.text.AntiAliasType du champ de texte est définie sur flash.text.AntiAliasType.ADVANCED.

Le type d’adaptation à la grille utilisé détermine si Flash Player force les lignes horizontales et verticales fortes à s’aligner sur une grille de pixels ou sous-pixels, ou pas du tout.

Pour la propriété flash.text.GridFitType, vous pouvez utiliser les valeurs de chaînes suivantes :

Contient la représentation HTML du contenu du champ de texte.

Flash Player prend en charge les balises HTML suivantes :

Flash Player et AIR prennent en charge les entités HTML suivantes :

Flash Player et AIR prennent également en charge les codes de caractères explicites, tels que & (esperluette ASCII) et € (symbole € Unicode).

Si la valeur est true, les styles paddingLeft et paddingRight n’ajoutent pas d’espace autour du texte du composant.

Début de la chaîne de styles hérités de cet élément UITextField. La méthode getStyle() accède à inheritingStyles[styleName] pour parcourir la totalité de la chaîne liée au prototype. Cet objet est défini par la méthode initProtoChain(). En règle générale, vous n’avez pas besoin d’accéder à cette propriété directement.

Nombre de caractères d’un champ de texte. Un caractère tel qu’une marque de tabulation (\t) compte comme un seul caractère.

Le nombre maximum de caractères que le champ de texte peut contenir, tels que saisis par un utilisateur. Un script peut insérer plus de texte que maxChars ne le permet ; la propriété maxChars n’indique que la quantité de texte qu’un utilisateur peut entrer. Si la valeur de la propriété est égale à 0, l’utilisateur peut entrer autant de texte que nécessaire.

Valeur maximale de scrollH.

Valeur maximale de scrollV.

Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. La valeur par défaut est true, ce qui signifie que, par défaut, toute occurrence d’InteractiveObject figurant dans la liste d’affichage reçoit des événements de souris ou d’autres événements de saisie utilisateur. Si la propriété mouseEnabled est définie sur false, l’occurrence ne reçoit aucun événement de souris (ni aucun autre événement de saisie utilisateur, tel qu’un événement de clavier). Aucun enfant de cette occurrence figurant dans la liste d’affichage n’est affecté. Pour modifier le comportement mouseEnabled de tous les enfants d’un objet figurant dans la liste d’affichage, utilisez flash.display.DisplayObjectContainer.mouseChildren.

Définir cette propriété ne distribue aucun événement. La méthode addEventListener() vous permet de créer une fonctionnalité interactive.

Valeur booléenne qui indique si Flash Player fait automatiquement défiler les champs de texte multiligne lorsque l’utilisateur clique sur le champ de texte et actionne la molette de sa souris. Par défaut, cette valeur est true. Cette propriété est utile si vous souhaitez empêcher le défilement des champs de texte en actionnant la molette de la souris, ou implémenter votre propre défilement de champs de texte.

Indique si le champ est un champ de texte multiligne. Si la valeur est true, le champ de texte est multiligne ; si la valeur est false, le champ de texte est un champ de texte sur une seule ligne. Dans un champ de type TextFieldType.INPUT, la valeur multiline détermine si la touche Entrée créé une nouvelle ligne (valeur false et la touche Entrée est ignorée). Si vous collez du texte dans un objet TextField avec une valeur multiline false, les nouvelles lignes sont éliminées du texte.

Profondeur de cet objet dans la hiérarchie de confinement. Ce nombre est utilisé par le code de mesure et de présentation. La valeur est 0 si ce composant n’est pas dans la liste DisplayList.

Début de la chaîne de styles non hérités de cet élément UITextField. La méthode getStyle() accède à la méthode nonInheritingStyles[styleName] pour parcourir la totalité de la chaîne liée au prototype. Cet objet est défini par la méthode initProtoChain(). En règle générale, vous n’avez pas besoin d’accéder à cette propriété directement.

Contrairement à la propriété textHeight, cela renvoie une valeur non nulle même si le texte est vide. Dans ce cas, elle renvoie la valeur de la propriété textHeight si le texte n’était pas vide.

Définit le nombre de lignes de texte d’un champ multiligne. Si la propriété wordWrap est définie sur true, le nombre de lignes augmente lorsque le texte contient des sauts de ligne.

Indique le jeu de caractères qu’un utilisateur peut rentrer dans le champ de texte. Si la valeur de la propriété restrict est null, vous pouvez entrer n’importe quel caractère. Si la valeur de la propriété restrict est une chaîne vide, aucun caractère ne peut être entré. Si la valeur de la propriété restrict est une chaîne de caractères, vous ne pouvez entrer que les caractères dans la chaîne du champ de texte. La chaîne est lue de gauche à droite. Vous pouvez spécifier une plage à l’aide du caractère (-). Seule l’interaction de l’utilisateur est limitée ; un script peut mettre n’importe quel texte dans le champ de texte. Cette propriété ne se synchronise pas avec les options de polices incorporées de l’inspecteur des propriétés.

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.

L’exemple suivant autorise uniquement les caractères en majuscules, les espaces et les nombres dans le champ de texte :

     my_txt.restrict = "A-Z 0-9";
     

L’exemple suivant exclut uniquement les caractères en minuscules :

     my_txt.restrict = "^a-z";
     

Insérez une barre oblique pour saisir un ^ ou un -. Les séquences acceptables sont \-, \^ ou \\. Si la barre oblique doit être un caractère réel dans la chaîne, vous devez également la faire précéder d’une autre barre oblique dans le code ActionScript. Par exemple, le code suivant inclut uniquement le tiret (-) et le signe circonflexe (^) :

     my_txt.restrict = "\\-\\^";
     

Le caractère ^ peut être utilisé n’importe où dans la chaîne pour faire alterner l’inclusion et l’exclusion des caractères. Le code suivant inclut uniquement des lettres en majuscules, mais exclut la lettre Q en majuscules :

     my_txt.restrict = "A-Z^Q";
     

Vous pouvez utiliser la séquence d’échappement \u pour créer des chaînes restrict. Le code suivant inclut uniquement les caractères ASCII allant de 32 à 126 (tilde).

     my_txt.restrict = "\u0020-\u007E";
     

Position de défilement horizontal actuelle. Si la propriété scrollH est 0, le texte ne défile pas horizontalement. Cette valeur de propriété est un entier qui représente la position horizontale en pixels.

Les unités du défilement horizontal sont les pixels, alors que les unités du défilement vertical sont les lignes. Le défilement horizontal est mesuré en pixels étant donné que la plupart des polices que vous utilisez sont généralement espacées de façon proportionnelle, c’est-à-dire que les caractères peuvent avoir différentes largeurs. Flash Player procède au défilement vertical par ligne dans la mesure où les utilisateurs préfèrent généralement consulter une ligne entière de texte. Même s’il existe plusieurs polices sur une ligne, la hauteur de la ligne s’adapte à la plus grande police utilisée.

Remarque : la propriété scrollH est de base zéro, contrairement à la propriété de défilement vertical scrollV qui est de base 1.

La position verticale du texte dans un champ de texte. La propriété scrollV est utile pour diriger les utilisateurs vers un paragraphe spécifique dans un long passage ou pour créer des champs de texte avec défilement.

Les unités du défilement vertical sont des lignes, alors que les unités du défilement horizontal sont des pixels. Si la première ligne qui s’affiche correspond à la première ligne du champ de texte, scrollV est défini sur 1 (non pas sur 0). Le défilement horizontal est mesuré en pixels étant donné que la plupart des polices que vous utilisez sont généralement espacées de façon proportionnelle et les caractères peuvent donc avoir différentes largeurs. Flash procède au défilement vertical par ligne dans la mesure où les utilisateurs préfèrent généralement consulter une ligne entière de texte. Même s’il existe plusieurs polices sur une ligne, la hauteur de la ligne s’adapte à la plus grande police utilisée.

Une valeur booléenne qui indique si le champ de texte peut être sélectionné. La valeur true indique que le texte est sélectionnable. La propriété selectable détermine si un champ de texte peut être sélectionné et non pas s’il peut être modifié. Un champ de texte dynamique peut être sélectionné, même s’il ne peut pas être modifié. Lorsqu’un champ de texte n’est pas sélectionnable, vous ne pouvez pas sélectionner son texte.

Si selectable est défini sur false, le texte du champ de texte ne répond pas aux commandes de sélection de la souris ou du clavier, et le texte ne peut pas être copié à l’aide de la commande Copier. Si selectable est défini sur true, le texte du champ de texte peut être sélectionné avec la souris ou le clavier, et le texte peut être copié à l’aide de la commande Copier. Vous pouvez sélectionner le texte de cette manière même si le champ de texte est un champ de texte dynamique et non un champ de texte de saisie.

Valeur d’index basée sur zéro du premier caractère de la sélection actuelle. Par exemple, le premier caractère est 0, le deuxième est 1, etc. Si aucun texte n’est sélectionné, cette propriété reprend la valeur de caretIndex.

Valeur d’index de base zéro du dernier caractère de la sélection actuelle. Par exemple, le premier caractère est 0, le deuxième est 1, etc. Si aucun texte n’est sélectionné, cette propriété reprend la valeur de caretIndex.

Netteté des bords du glyphe dans ce champ de texte. Cette propriété s’applique uniquement si la propriété flash.text.AntiAliasType du champ de texte est définie sur flash.text.AntiAliasType.ADVANCED. La plage de sharpness est comprise entre -400 et 400. Si vous tentez de définir sharpness sur une valeur en dehors de cette plage, Flash définit cette propriété sur la valeur valide la plus proche, soit -400 ou 400.

Associe une feuille de style au champ de texte. Pour plus d’informations sur la création de feuilles de style, voir la classe StyleSheet et le Guide du développeur d’ActionScript 3.0.

Vous pouvez modifier la feuille de style associée à un champ de texte à la demande. Si vous modifiez la feuille de style en cours d’utilisation, le champ de texte est redessiné avec la nouvelle feuille de style. Vous pouvez définir la feuille de style sur null ou undefined pour ne pas en utiliser. Si la feuille de style en cours d’utilisation est supprimée, le champ de texte est redessiné sans feuille de style.

Remarque : lorsque la feuille de style est supprimée, le contenu de TextField.text et TextField.htmlText se modifie pour intégrer le formatage qui a été appliqué auparavant par la feuille de style. Pour préserver le contenu d’origine de TextField.htmlText sans le formatage, enregistrez la valeur dans une variable avant de supprimer la feuille de style.

Indique si cet objet est spécifié dans l’ordre de tabulation. Lorsque cet objet figure dans l’ordre de tabulation, la valeur est true. Sinon, elle est false. La valeur par défaut est false, sauf pour les éléments suivants :

• Pour un objet SimpleButton, la valeur est true.
• Pour un objet TextField avec type = "input", la valeur est true.
• Pour un objet Sprite ou MovieClip avec buttonMode = true, la valeur true.

Spécifie l’ordre de tabulation des objets dans un fichier SWF. La propriété tabIndex est réglée sur -1 par défaut, ce qui signifie qu’aucun index de tabulation n’est associé à l’objet.

Si un objet actuellement affiché dans le fichier SWF contient une propriété tabIndex, l’ordre de tabulation automatique est désactivé : l’ordre de tabulation est alors calculé à partir des propriétés tabIndex des objets contenus dans le fichier SWF. L’ordre de tabulation personnalisé inclut uniquement les objets dotés de propriétés tabIndex.

La propriété tabIndex peut être un entier non négatif. Les objets sont triés selon leurs propriétés tabIndex, par ordre croissant. Un objet dont la valeur de tabIndex est définie sur 1 précède celui dont la valeur de tabIndex est 2. N’appliquez pas la même valeur tabIndex à plusieurs objets.

L’ordre de tabulation personnalisé défini par la propriété tabIndex est flat. Cela signifie que les relations hiérarchiques des objets contenus dans le fichier SWF ne sont pas prises en compte. Tous les objets du fichier SWF dotés de propriétés tabIndex sont placés dans l’ordre de tabulation, qui est déterminé par l’ordre des valeurs tabIndex.

Remarque : pour définir l’ordre de tabulation des occurrences de TLFTextField, distribuez l’objet d’affichage enfant de TLFTextField en tant qu’objet InteractiveObject, puis définissez la propriété tabIndex. Par exemple :

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Une chaîne qui correspond au texte du champ de texte. Les lignes sont séparées par le caractère de retour chariot (’\r’, ASCII 13). Cette propriété contient du texte non formaté dans le champ de texte, sans balises HTML.

Pour obtenir le texte du formulaire HTML, utilisez la propriété htmlText.

Remarque : si une feuille de style est appliquée au champ de texte, le contenu de la propriété text est interprété au format HTML.

Couleur du texte dans un champ de texte, au format hexadécimal. Le système de couleur hexadécimal utilise les six chiffres pour représenter les valeurs de couleur. Chaque chiffre a 16 valeurs ou caractères possibles. La plage de caractères va de 0 à 9, puis de A à F. Par exemple, le noir correspond à 0x000000 et le blanc à 0xFFFFFF.

Hauteur du texte en pixels.

Largeur du texte en pixels.

Epaisseur des bords du glyphe dans ce champ de texte. Cette propriété s’applique uniquement lorsque flash.text.AntiAliasType est défini sur flash.text.AntiAliasType.ADVANCED.

La plage de thickness est comprise entre -200 et 200. Si vous tentez de définir thickness sur une valeur en dehors de cette plage, cette propriété est définie sur la valeur valide la plus proche, soit -200 ou 200.

Type du champ de texte. L’une des constantes TextFieldType suivantes : TextFieldType.DYNAMIC, qui spécifie un champ de texte dynamique, que l’utilisateur ne peut pas modifier, ou TextFieldType.INPUT, qui spécifie un champ de texte de saisie, que l’utilisateur peut modifier.

Spécifie si le formatage du texte peut être copié et collé en même temps que le corps du texte. Lorsque défini sur true, Flash Player copie et colle le formatage (tel que les paramètres d’alignement, gras et italique) lorsque vous copiez et collez entre différents champs. Les champs de texte d’origine et de destination pour la procédure de copie et collage doivent disposer d’une propriété useRichTextClipboard définie sur true. La valeur par défaut est false.

Valeur booléenne indiquant si le champ de texte comporte un retour à la ligne. Si la valeur de wordWrap est true, le champ de texte comporte un retour à la ligne ; si la valeur est false, le champ de texte ne comporte pas de retour à la ligne. La valeur par défaut est false.

Ajoute la chaîne spécifiée par le paramètre newText à la fin du texte du champ de texte. Cette méthode est plus efficace que l’affectation d’addition (+=) pour une propriété text (telle que someTextField.text += moreText), notamment pour les champs de texte dont le contenu est volumineux.

Paramètres

Renvoie un rectangle représentant le cadre de sélection du caractère.

Paramètres

Renvoie la valeur d’index de base zéro du caractère au point spécifié par les paramètres x et y.

Paramètres

En fonction d’un caractère d’index, renvoie l’index du premier caractère dans le même paragraphe.

Paramètres

Renvoie une référence DisplayObject pour l’id donné, pour une image ou un fichier SWF qui a été ajouté à un champ de texte qui applique le format HTML à l’aide de la balise <img>. La balise <img> est au format suivant :

   <img src = 'filename.jpg' id = 'instanceName' >

Paramètres

Renvoie la valeur d’index de base zéro de la ligne au point spécifié par les paramètres x et y.

Paramètres

Renvoie la valeur d’index de base zéro de la ligne qui contient le caractère spécifié par le paramètre charIndex.

Paramètres

Renvoie le nombre de caractères d’une ligne de texte donnée.

Paramètres

Renvoie les informations métriques relatives à une ligne de texte donnée.

Paramètres

Renvoie l’index du premier caractère de la ligne spécifiée par le paramètre lineIndex.

Paramètres

Renvoie le texte de la ligne spécifiée par le paramètre lineIndex.

Paramètres

En fonction d’un caractère d’index, renvoie la longueur du paragraphe qui contient le caractère donné. La longueur est mesurée à partir du premier caractère du paragraphe (tel que renvoyé par getFirstCharInParagraph()) et non pas par rapport à l’index de caractères qui a été transmis.

Paramètres

Extrait une propriété de style ayant été définie n’importe où dans la chaîne de recherche de style de ce composant.

Cette méthode étant utilisée pour obtenir un type de propriété de style, la valeur renvoyée peut être une valeur booléenne, de chaîne, de nombre, int, uint (pour une couleur RVB), de classe (pour un habillage) ou un type d’objet. Par conséquent, le type renvoyé est simplement spécifié en tant que *.

Si vous obtenez une propriété de style particulière, vous connaissez son type et souhaitez souvent stocker le résultat dans une variable de ce type. Aucune projection n’est nécessaire depuis * vers ce type.

var backgroundColor:uint = getStyle("backgroundColor");

Si la propriété de style n’a pas été définie à un endroit quelconque de la chaîne de recherche de style, la valeur renvoyée par la méthode getStyle() est undefined. Notez que undefined est une valeur spéciale qui ne correspond pas à false, "", NaN, 0 ou null. Aucune valeur de style valide n’est jamais undefined. Vous pouvez utiliser la méthode IStyleManager2.isValidStyleValue() pour vérifier si une valeur a été définie.

Paramètres

Renvoie un objet TextFormat qui contient des informations de formatage pour la plage de texte délimitée par les paramètres beginIndex et endIndex. Seules les propriétés communes à l’ensemble du texte spécifié sont définies dans l’objet TextFormat obtenu. Toute propriété qui est mixed, ce qui signifie qu’elle a différentes valeurs à différents endroits du texte, a la valeur null.

Si vous ne spécifiez pas de valeurs pour ces paramètres, cette méthode s’applique à l’ensemble du texte dans le champ de texte.

Le tableau suivant décrit trois utilisations possibles :

Paramètres

Renvoie un objet UITextFormat contenant des informations de formatage pour ce composant. Cette méthode est similaire à la méthode getTextFormat() de la classe flash.text.TextField, mais elle renvoie un objet UITextFormat au lieu d’un objet TextFormat.

La classe UITextFormat étend la classe TextFormat pour ajouter les méthodes de mesure de texte measureText() et measureHTMLText().

Remplace la sélection actuelle par le contenu du paramètre value. Le texte est inséré au niveau de la sélection actuelle, à l’aide du format de caractère par défaut actuel et du format de paragraphe par défaut. Le texte n’est pas traité en tant que texte HTML.

Vous pouvez utiliser la méthode replaceSelectedText() pour insérer et effacer du texte sans perturber le formatage des caractères et de paragraphe du reste du texte.

Remarque : cette méthode ne fonctionne pas lorsqu’une feuille de style est appliquée au champ de texte.

Paramètres

Remplace la plage de caractères que les paramètres beginIndex et endIndex spécifient par le contenu du paramètre newText. Comme prévu, le texte situé entre de beginIndex et endIndex-1 est remplacé.

Remarque : cette méthode ne fonctionne pas lorsqu’une feuille de style est appliquée au champ de texte.

Paramètres

Définit la couleur de police du texte.

Paramètres

Définit le focus sur ce composant. Le composant peut à son tour transmettre le focus à un sous-composant.

Remarque : seules les commandes TextInput et TextArea affichent une surbrillance lorsque cette méthode définit le focus. Toutes les commandes s’affichent en surbrillance lorsque l’utilisateur les parcourt avec la touche de tabulation.

Définit comme sélectionné le texte désigné par les valeurs d’index des premier et dernier caractères, spécifiés par les paramètres beginIndex et endIndex. Si les valeurs des deux paramètres sont identiques, cette méthode définit le point d’insertion, comme si vous définissiez la propriété caretIndex.

Paramètres

Applique à la partie sélectionnée d’un champ de texte le format spécifié par le paramètre format. La valeur de format doit être un objet TextFormat qui spécifie les modifications à apporter au formatage du texte. Seules les propriétés non null de format sont appliquées au champ de texte. Toute propriété de format qui est définie sur null n’est pas appliquée. Par défaut, toutes les propriétés d’un nouvel objet TextFormat créé sont définies sur null.

Remarque : cette méthode ne fonctionne pas lorsqu’une feuille de style est appliquée au champ de texte.

La méthode setTextFormat() modifie le formatage de texte appliquée à une plage de caractères ou à l’ensemble du corps de texte d’un champ de texte. Pour appliquer les propriétés de format à l’ensemble du texte du champ, ne spécifiez pas de valeur pour beginIndex et endIndex. Pour appliquer les propriétés de format à une plage de texte, spécifiez les valeurs des paramètres beginIndex et endIndex. Vous pouvez utiliser la propriété length pour déterminer les valeurs d’index.

Les deux types d’information de formatage d’un objet TextFormat correspondent au formatage au niveau des caractères et au formatage au niveau du paragraphe. Chaque caractère d’un champ de texte peut avoir ses propres paramètres de mise en forme de caractère, tels que le nom et la taille de la police, gras et italique.

Pour les paragraphes, le premier caractère du paragraphe est analysé pour les paramètres de mise en forme du paragraphe entier. La marge gauche, la marge droite et le retrait sont des exemples de paramètres de mise en forme de paragraphe.

Tout texte inséré manuellement par l’utilisateur, ou remplacé par la méthode replaceSelectedText(), reçoit le formatage par défaut pour un nouveau texte, et non celui spécifié pour le point d’insertion du texte. Pour définir le formatage par défaut du nouveau texte, utilisez defaultTextFormat.

Paramètres

Tronquer le texte pour l’ajuster horizontalement dans la zone définie pour la commande et ajouter des points de suspension, trois points (...) au texte.

Paramètres