TextInput  - AS3 Flex

Indique si les espaces blancs supplémentaires (espaces, sauts de ligne, etc.) doivent être supprimés dans un contrôle TextInput contenant du texte HTML.

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

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement condenseWhiteChanged .

Permet de transmettre une valeur au composant lorsque vous l’utilisez dans un rendu d’élément ou un éditeur d’élément. Vous utilisez généralement la liaison des données pour lier un champ de la propriété data à une propriété de ce composant.

Lorsque vous utilisez le contrôle comme rendu d’élément supplémentaire ou éditeur d’élément supplémentaire, Flex écrit automatiquement la valeur actuelle de l’élément dans la propriété text de ce contrôle.

Vous ne pouvez pas définir cette propriété dans MXML.

La valeur par défaut est null.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement dataChange .

Eléments de l’API associés

Indique si ce contrôle est utilisé pour entrer des mots de passe. Si la valeur est true, le champ n’affiche pas le texte entré. En revanche, chaque caractère de texte entré dans le contrôle s’affiche sous la forme du caractère *.

La valeur par défaut est false.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement displayAsPasswordChanged .

Indique si l’utilisateur est autorisé à modifier le texte dans ce contrôle. Si la valeur est true, l’utilisateur peut modifier le texte.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement editableChanged .

Indicateur qui signale si l’IME doit être activé lorsque le composant reçoit le focus.

Fabrique de module qui fournit le contexte des polices de ce composant.

Position dans la zone de contenu du pixel le plus à gauche qui est actuellement affiché (la zone de contenu inclut tous les contenus d’un contrôle, pas seulement la portion qui est actuellement affichée). Cette propriété est toujours définie sur 0 et ignore les changements si la propriété wordWrap est définie sur true.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement horizontalScrollPositionChanged .

Spécifie le texte affiché par le contrôle TextInput, y compris la balise HTML définissant les styles du texte. Lorsque vous spécifiez du texte HTML dans cette propriété, vous pouvez utiliser le sous-jeu de balises HTML pris en charge par le contrôle Flash TextField.

Lorsque vous définissez cette propriété, le marqueur HTML est appliqué après l’application des styles CSS pour l’instance TextInput. Lorsque vous obtenez cette propriété, le marqueur HTML inclut les styles CSS.

Par exemple, si vous le définissez en tant que chaîne (par exemple « Ceci est un exemple de marqueur <b>bold</b> »), le texte « Ceci est un exemple de marqueur bold » s’affiche dans le contrôle TextInput avec les styles CSS qui s’appliquent normalement. De plus, le terme « bold » (gras) s’affiche en gras à cause du marqueur <b>.

Les marqueurs HTML utilisent des caractères comme < et >, qui ont une signification particulière en langage XML (et par conséquent MXML). Ainsi, le code suivant n’est pas conforme pour la compilation :

      <mx:TextInput htmlText="This is an example of <b>bold</b> markup"/>
      

Trois méthodes permettent de contourner ce problème.

• Définissez la propriété htmlText dans une méthode ActionScript appelée comme gestionnaire initialize :

        <mx:TextInput id="myTextInput" initialize="myTextInput_initialize()"/>
        

  dont la méthode TextInput_initialize se trouve dans la section CDATA d’un script:

        <fx:Script>
        <![CDATA[
        private function myTextInput_initialize():void {
            myTextInput.htmlText = "This is an example of <b>bold</b> markup";
        }
        ]]>
        </fx:Script>
        
        

  Ceci est l’approche la plus simple, car le marqueur HTML reste facilement lisible. Notez que vous devez attribuer un id au contrôle TextInput afin de pouvoir vous y référer dans le gestionnaire initialize.

• Spécifiez la propriété htmlText en utilisant une balise enfant avec une section CDATA. Une section CDATA en langage XML contient des données de caractères pour lesquelles les caractères comme < et > n’ont pas de signification particulière.

        <mx:TextInput>
            <mx:htmlText><![CDATA[This is an example of <b>bold</b> markup]]></mx:htmlText>
        <mx:TextInput/>
        

  Vous devez écrire la propriété htmlText en tant que balise enfant au lieu d’un attribut sur la balise <mx:TextInput>, car le langage XML n’autorise pas la section CDATA comme valeur d’attribut. Notez que le marqueur est lisible, mais la section CDATA rend cette approche plus compliquée.

• Utilisez un attribut hmtlText dont toutes les instances de caractères de marqueur HTML < et > dans la valeur d’attribut sont écrites, au lieu d’utiliser les « entités » XML < et > :

        <mx:TextInput htmlText="This is an example of <b>bold</b> markup"/>
        

  Adobe ne recommande pas cette approche, car le marqueur HTML devient presque impossible à lire.

Si la propriété condenseWhite a la valeur true lorsque vous définissez la propriété htmlText, plusieurs caractères d’espace sont condensés, comme dans les navigateurs HTML. Par exemple, trois espaces consécutifs sont affichés sous la forme d’un espace unique. La valeur par défaut de condenseWhite est false. Vous devez donc définir condenseWhite sur true pour réduire l’espace.

Si vous relisez la propriété htmlText peu de temps après l’avoir définie, vous obtenez la même chaîne que celle que vous avez définie. Toutefois, après l’exécution de l’objet LayoutManager, la valeur change pour inclure un marqueur supplémentaire comprenant les styles CSS.

La définition de la propriété htmlText affecte la propriété text de plusieurs manières. Si vous lisez la propriété text peu de temps après avoir défini la propriété htmlText, vous obtenez la valeur null. Cela indique que la propriété text correspondant à la nouvelle propriété htmlText n’a pas encore été déterminée. Toutefois, après l’exécution de l’objet LayoutManager, la propriété text se transforme en chaîne htmlText et tous les marqueurs HTML sont supprimés. En fait, la valeur correspond aux caractères que le contrôle TextInput affiche réellement.

A l’inverse, si vous définissez la propriété text, toute propriété htmlText précédemment définie devient obsolète. Si vous lisez la propriété htmlText peu de temps après avoir défini la propriété text, vous obtenez la valeur null. Cela indique que la propriété htmlText qui correspond à la nouvelle propriété text n’a pas encore été déterminée. Toutefois, après l’exécution du gestionnaire LayoutManager, la valeur de la propriété htmlText devient le nouveau texte et inclut un marqueur supplémentaire pour les styles CSS.

Pour que le gestionnaire LayoutManager s’exécute immédiatement, vous pouvez appeler la méthode validateNow() sur le contrôle TextInput. Par exemple, vous pouvez obtenir des propriétés htmlText, appeler la méthode validateNow() et récupérer immédiatement la propriété text correspondante qui n’a pas le marqueur HTML.

Si vous définissez les deux propriétés text et htmlText dans ActionScript, celle définie en dernier prend effet. Ne définissez pas les deux dans MXML, car MXML ne garantit pas que les propriétés d’une instance puissent être définies dans un ordre particulier.

Définir la propriété text ou htmlText à l’intérieur d’une boucle est une opération rapide, car le contrôle TextField sous-jacent qui effectue réellement le rendu du texte n’est pas mis à jour tant que le gestionnaire LayoutManager s’exécute.

Si vous essayez de définir cette propriété sur null, elle est à la place définie sur la chaîne vide. Si la propriété a temporairement la valeur null, cela indique que la propriété text a été récemment définie et que la propriété htmlText correspondante n’a pas encore été déterminée.

La valeur par défaut est "".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement htmlTextChanged .

Eléments de l’API associés

Spécifie le mode IME (éditeur de méthode d’entrée). L’éditeur IME permet aux utilisateurs d’entrer du texte en chinois, japonais et coréen. Flex définit le mode IME spécifié lorsque le contrôle est mis en focus et rétablit la valeur précédente lorsque le contrôle est désactivé.

La classe flash.system.IMEConversionMode définit des constantes pour les valeurs possibles de cette propriété. Vous pouvez également spécifier null si vous ne souhaitez pas spécifier d’éditeur IME.

La valeur par défaut est null.

Eléments de l’API associés

Nombre de caractères affichés dans la zone de texte.

La valeur par défaut est 0.

Lorsqu’un composant est utilisé en tant que rendu d’élément supplémentaire ou éditeur d’élément supplémentaire, Flex initialise la propriété listData du composant avec les données appropriées du contrôle List. Le composant peut ensuite utiliser la propriété listData pour initialiser la propriété data du rendu d’élément supplémentaire ou de l’éditeur d’élément supplémentaire.

Vous ne définissez pas cette propriété dans MXML ou ActionScript. Flex la définit lorsque le composant est utilisé comme rendu d’élément supplémentaire ou éditeur d’élément supplémentaire.

La valeur par défaut est null.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement dataChange .

Eléments de l’API associés

Nombre maximal de caractères que les utilisateurs peuvent entrer dans un champ de texte. Cette propriété ne limite pas la longueur de texte spécifiée en définissant la propriété text ou htmlText du contrôle.

La valeur par défaut est 0, ce qui correspond à un cas particulier indiquant un nombre illimité.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement maxCharsChanged .

Si la valeur est true, les appels de la méthode drawFocus() de ce contrôle sont transmis à la méthode drawFocus() de son parent. Cela est utilisé lorsqu’un TextInput fait partie d’un contrôle composite tel que NumericStepper ou ComboBox.

Indique le jeu de caractères que l’utilisateur peut saisir dans le contrôle. 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é. Cette propriété ne limite que l’interaction avec l’utilisateur ; un script peut mettre tout texte dans le champ de texte. 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.

Flex analyse la chaîne de gauche à droite. Vous pouvez spécifier une plage à l’aide du 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.

Comme certains caractères ont une signification particulière lorsqu’ils sont utilisés dans la propriété restrict, vous devez utiliser des barres obliques inverses pour spécifier les caractères de type littéral -, ^ et \. Lorsque vous utilisez la propriété restrict comme attribut dans une balise MXML, utilisez des barres obliques inverses uniques, comme dans cet exemple : \^\-\\. Lorsque vous définissez la propriété restrict dans une expression ActionScript, utilisez des barres obliques inverses doubles, comme dans cet exemple : \\^\\-\\\.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement restrictChanged .

Indicateur signalant si le texte de TextInput peut être sélectionné.

Index de base zéro de la position suivant le dernier caractère dans la selection en cours (équivalent à l’index de base un du dernier caractère). Si le dernier caractère de la sélection, par exemple, est le cinquième caractère, cette propriété a la valeur 5. Lorsque le contrôle reçoit le focus, la sélection est visible si les propriétés selectionAnchorIndex et selectionActiveIndex sont définies toutes les deux.

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. Lorsque le contrôle reçoit le focus, la sélection est visible si les propriétés selectionAnchorIndex et selectionActiveIndex sont définies toutes les deux.

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. Lorsque le contrôle reçoit le focus, la sélection est visible si les propriétés selectionBeginIndex et selectionEndIndex sont définies toutes les deux.

La valeur par défaut est 0.

Index de base zéro de la position suivant le dernier caractère dans la selection en cours (équivalent à l’index de base un du dernier caractère). Si le dernier caractère de la sélection, par exemple, est le cinquième caractère, cette propriété a la valeur 5. Lorsque le contrôle reçoit le focus, la sélection est visible si les propriétés selectionBeginIndex et selectionEndIndex sont définies toutes les deux.

La valeur par défaut est 0.

Texte ordinaire apparaissant dans le contrôle. Son apparence est fonction des styles CSS de son contrôle Label.

Toutes les balises HTML de la chaîne de caractères sont ignorées et apparaissent telles qu’elles sont saisies dans la chaîne. Pour afficher un texte mis en forme à l’aide de balises HTML, utilisez plutôt la propriété htmlText. Si vous définissez la propriété htmlText, le code HTML remplace le texte défini à l’aide de cette propriété et la propriété text renvoie une version de texte ordinaire du texte HTML, dépouillée de toutes les balises HTML. Pour plus d’informations, voir la propriété htmlText.

Pour inclure les caractères spéciaux de signe inférieur à (<), de signe supérieur à (>) ou de perluète (&) dans le texte, enveloppez la chaîne de caractères dans la balise CDATA. Vous pouvez également utiliser des entités de caractères HTML pour les caractères spéciaux, par exemple <.

Si vous essayez de définir cette propriété sur null, elle est à la place définie sur la chaîne vide. La propriété text peut avoir temporairement la valeur null, ce qui indique que la propriété htmlText a été récemment définie et que la propriété text n’a pas encore été déterminée.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement textChanged .

Objet UITextField interne qui effectue le rendu du texte de ce contrôle TextInput.

hauteur du texte.

La valeur de la propriété textHeight est correcte une fois que le composant a été validé uniquement. Si vous définissez la propriété text, puis demandez immédiatement la propriété textHeight, vous risquez de recevoir une valeur incorrecte. Vous devez attendre la validation du composant ou appeler la méthode validateNow pour obtenir la valeur. Ce comportement est différent de celui du contrôle flash.text.TextField, qui met immédiatement la valeur à jour.

Eléments de l’API associés