IEditableText  - AS3 Flex

Options d’accessibilité actuelles de l’objet d’affichage. Si vous modifiez la propriété accessibilityProperties ou l’un de ses champs dans accessibilityProperties, vous devez appeler la méthode Accessibility.updateProperties() pour appliquer vos modifications.

Remarque : pour tout objet créé dans l’environnement de création de Flash, la valeur de accessibilityProperties est préremplie avec les informations que vous avez entrées dans le panneau Accessibilité pour cet objet.

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.

Indicateur précisant si le texte est modifiable.

La valeur par défaut est false.

Indique si le composant peut accepter une interaction de l’utilisateur. Même lorsque la propriété enabled est définie sur false, certains composants continuent à répondre aux interactions de souris telles que mouseOver. Par conséquent, pour désactiver entièrement des classes UIComponent, vous devez également définir la valeur de la propriété mouseEnabled sur false. Si vous définissez la propriété enabled sur false pour un conteneur, Flex estompe la couleur du conteneur et de ses enfants et empêche toute intervention de l’utilisateur sur le conteneur et ses enfants.

Indique si le composant peut recevoir le focus par tabulation. Vous pouvez définir la propriété focusEnabled sur false lorsqu’un composant UIComponent est utilisé comme sous-composant d’un autre composant, pour que cet autre composant devienne l’entité pouvant recevoir le focus. Si la valeur de cette propriété est false, le focus est transféré au premier parent ayant une propriété focusEnable définie sur true.

La valeur par défaut est true, sauf pour le composant spark.components.Scroller. Pour ce composant, la valeur par défaut est false.

Position de défilement horizontal du texte.

Contrôle le retour à la ligne dans le texte. Cette propriété correspond au style lineBreak.

Eléments de l’API associés

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.

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.

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";
     

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.

La position active ou de dernier clic de la sélection. Si l’implémentation ne prend pas en charge le point d’ancrage de la sélection, il s’agit du dernier caractère de la sélection.

Le point d’ancrage, ou la position de premier clic, de la sélection. Si l’implémentation ne prend pas en charge le point d’ancrage de la sélection, il s’agit du premier caractère de la sélection.

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;
	 

Position de défilement vertical du texte.

Ajoute le texte spécifié à la fin du composant de texte, comme si vous aviez cliqué à la fin et l’aviez tapé.

Un point d’insertion est alors défini après le nouveau texte. Si nécessaire, le texte défile pour vous assurer que le point d’insertion est visible.

Paramètres

Insère le texte spécifié dans le composant de texte comme si vous l’aviez tapé.

Si une plage a été sélectionnée, le nouveau texte remplace le texte sélectionné. S’il existe un point d’insertion, le nouveau texte est inséré.

Un point d’insertion est alors défini après le nouveau texte. Si nécessaire, le texte défile pour vous assurer que le point d’insertion est visible.

Paramètres

Effectuez un défilement de façon à ce que la plage spécifiée figure dans la vue.

Paramètres

Sélectionne l’ensemble du texte.

Sélectionne une plage de caractères spécifiée.

Si l’une des deux positions est négative, la plage de texte est désélectionnée.

Paramètres

Attribuez le focus à ce champ textuel.