TextArea  - AS3 Flex

Indique si les espaces blancs supplémentaires (espaces, sauts de ligne, etc.) doivent être supprimés dans un contrôle TextArea 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.

La valeur par défaut est 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 editableChanged .

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

Indique si la barre de défilement horizontale est toujours active (ScrollPolicy.ON), toujours inactive (ScrollPolicy.OFF) ou si elle est activée lorsque cela est nécessaire (ScrollPolicy.AUTO).

La valeur par défaut est ScrollPolicy.AUTO.

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.

La valeur par défaut est 0.

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

Spécifie le texte affiché par le contrôle TextArea, y compris la balise HTML définissant les styles de ce 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 TextArea. 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 TextArea 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:TextArea 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:TextArea id="myTextArea" initialize="myTextArea_initialize()"/>
        

  dans laquelle la méthode myTextArea_initialize se trouve dans la section CDATA d’un script :

        <fx:Script>
        <![CDATA[
        private function myTextArea_initialize():void {
            myTextArea.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 TextArea 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:TextArea>
            <mx:htmlText><![CDATA[This is an example of <b>bold</b> markup]]></mx:htmlText>
        <mx:TextArea/>
        

  Vous devez écrire la propriété htmlText en tant que balise enfant au lieu d’un attribut sur la balise <mx:TextArea>, 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 attributhmtlTextdont 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:TextArea 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 TextArea 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 TextArea. 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 signifie aucune limite.

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 .

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 : \\^\\-\\\.

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

Eléments de l’API associés

Précise si le texte peut être sélectionné. Le fait de rendre le texte sélectionnable permet de copier du texte à partir du contrôle.

La valeur par défaut est true.

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.

Objet flash.text.StyleSheet pouvant effectuer des rendus sur le texte du contrôle TextArea. Utilisé pour le contrôle détaillé des styles HTML du texte. Pour plus d’informations, voir la documentation sur la classe flash.text.StyleSheet.

La valeur par défaut est null.

Eléments de l’API associés

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.

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