Forums Développement Multimédia

Les formations Mediabox
Les formations Mediabox

Le contrôle Spark RichText

Compatible Flex 4. Cliquer pour en savoir plus sur les compatibilités.Compatible ActionScript 3. Cliquer pour en savoir plus sur les compatibilités.Par tannoy (Antony Chauviré), le 26 avril 2010 – 21:44

Cet article est une traduction de l'aide Adobe Flex.

Adobe a donné son accord concernant la traduction de la documentation.

Introduction

Le contrôle RichText est un des contrôles de texte Spark. Il peut afficher du texte dans un format riche, avec de multiples formats de caractères et de paragraphes. Cependant, il est non-interactif: il ne supporte pas les liens hypertexte, le défilement, la sélection, ou l'édition. Si vous souhaitez un contrôle qui prend en charge le texte formaté plus le défilement, la sélection et l'édition, vous pouvez utiliser le contrôle RichEditableText.

Pour spécifier le texte, le contrôle RichText supporte les propriétés textFlow, text, et content. Si vous définissez la propriété text, le contenu est lu comme un chaîne de caractères; les balises telles que <p> et <img> sont ignorées. Si vous définissez les propriétés textFlow ou content, alors le contenu est traité par TLF et stocké comme un objet TextFlow. Les balises telles que <p> et <img> sont reconnues comme des instances des classes ParagraphElement et InlineGraphicImageElement.

Pour créer un contrôle RichText, vous utilisez la balise <s:RichText> en MXML, comme le montre l'exemple suivant:

<?xml version="1.0"?>
<!-- sparktextcontrols/RichTextExample.mxml -->
<s:Application 
    xmlns:fx="http://ns.adobe.com/mxml/2009"    
    xmlns:mx="library://ns.adobe.com/flex/mx"     
    xmlns:s="library://ns.adobe.com/flex/spark">
 
    <s:layout> 
        <s:VerticalLayout/> 
    </s:layout>
 
    <!-- You can display simple text with the text property. -->  
    <s:RichText text="Hello World!"/>
 
    <!-- Or the text child tag. -->  
    <s:RichText>
        <s:text>
            Hello World!
        </s:text>        
    </s:RichText>
 
    <!-- You can display formatted text with the default property. -->  
    <s:RichText>
        Hello <s:span fontSize='16'>BIG NEW</s:span> World!
    </s:RichText>
 
    <!-- Or the TextFlow child tag. -->  
    <s:RichText>
        <s:textFlow>
            <s:TextFlow>
                Hello <s:span fontSize='16'>BIG NEW</s:span> World!
            </s:TextFlow>
        </s:textFlow>
    </s:RichText>
 
</s:Application>

Le fichier SWF de l'exemple ci-dessus est affiché ci-dessous :

L"extension Adobe Flash Plugin est nécessaire pour afficher ce contenu.

Le texte dans un contrôle RichText peut être aligné horizontalement et verticalement mais il ne peut être défilé. Un saut de ligne est créé lorsque le contenu atteint le bord droit des dimensions du contrôle. Si le contenu s'étend en dessous du bas du contrôle, il est coupé. Il est également coupé si vous n'autorisez pas les sauts de ligne, en définissant la propriété de style lineBreak sur explicit et si vous ajoutez du contenu qui dépasse le bord droit du contrôle.

Le contenu d'un contrôle RichText peut-être exporté au format XML en utilisant la méthode export(), qui produit du XML. Pour un exemple d'utilisation de la méthode export(), regardez http://blog.flexexamples.com/2009/07/25/exporting-a-textflow-object-in-flex-4/

Pour plus d'informations sur l'utilisation de TLF avec des contrôles de texte Spark, regardez Using Text Layout Framework.