TextConverter  - AS3

Nombre de formats.

Enregistrez un nouveau format d’importation/exportation. Le nouveau format sera ajouté à la fin, en tant que priorité la plus faible. L’emplacement peut être important pour les clients ayant plusieurs choix de format à utiliser, comme par exemple lors de l’importation à partir du presse-papiers externe. Le nouveau format peut prendre en charge l’importation et/ou l’exportation. Si le format a déjà été ajouté, il sera présent dans plusieurs emplacements. La première occurrence trouvée sera utilisée.

Paramètres

Enregistrez un nouveau format d’importation/exportation, à l’emplacement spécifié. L’emplacement peut être important pour les clients ayant plusieurs choix de format à utiliser, comme par exemple lors de l’importation à partir du presse-papiers externe. Les nombres faibles indiquent une priorité élevée ; ces convertisseurs seront essayés en premier. Le nouveau format peut prendre en charge l’importation et/ou l’exportation. Si le format a déjà été ajouté, il sera présent dans plusieurs emplacements. La première occurrence trouvée sera utilisée.

Paramètres

Exporte un objet TextFlow vers un format spécifié.

Utilisez l’une des constantes statiques fournies avec cette classe, un type MIME ou un format défini par l’utilisateur pour les exportateurs définis par l’utilisateur, pour spécifier le paramètre format :

• TextConverter.TEXT_FIELD_HTML_FORMAT
• TextConverter.PLAIN_TEXT_FORMAT
• TextConverter.TEXT_LAYOUT_FORMAT

Spécifiez le type des données exportées dans le paramètre conversionType avec l’une des constantes statiques fournies par la classe ConversionType ou un type de données défini par l’utilisateur pour les exportateurs définis par l’utilisateur :

• ConversionType.STRING_TYPE
• ConversionType.XML_TYPE

Paramètres

Eléments de l’API associés

Crée et renvoie un convertisseur d’exportation, que vous pouvez ensuite utiliser pour exporter à partir d’un objet TextFlow vers une chaîne source ou un objet XML. Utilisez cette fonction si vous devez effectuer de nombreuses exportations. Cela revient à appeler la méthode flashx.textLayout.conversion.TextConverter.export().

Utilisez l’une des constantes statiques fournies avec cette classe pour spécifier le paramètre format :

• TextConverter.TEXT_FIELD_HTML_FORMAT
• TextConverter.PLAIN_TEXT_FORMAT
• TextConverter.TEXT_LAYOUT_FORMAT

Si le format a été ajouté plusieurs fois, la première occurrence trouvée sera utilisée.

Paramètres

Eléments de l’API associés

package flashx.textLayout.conversion.examples
{
    import flashx.textLayout.conversion.ConversionType;
    import flashx.textLayout.conversion.ITextExporter;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.elements.TextFlow;
    
    public class getExporter_example 
    {
        // Serialize the TextFlow into a String
        public function export(textFlow:TextFlow):String
        {
            var exporter:ITextExporter = TextConverter.getExporter(TextConverter.TEXT_LAYOUT_FORMAT);
            return exporter.export(textFlow, ConversionType.STRING_TYPE) as String;
        }
    }
}

Renvoie le nom de format pour l’index-ième format.

Paramètres

Renvoie le FormatDescriptor pour l’index-ième format.

Paramètres

Crée et renvoie un convertisseur d’importation, qui vous permet ensuite d’importer à partir d’une chaîne source, d’un objet XML ou de n’importe quel format de données défini par l’utilisateur vers un objet TextFlow. Utilisez cette méthode, si vous devez exécuter de nombreuses importations ou si vous voulez gérer des erreurs lors de l’importation. Cela revient à appeler la méthode flashx.textLayout.conversion.TextConverter.importToFlow().

Utilisez l’une des constantes statiques fournies avec cette classe pour spécifier le paramètre format, un type MIME ou un format de données défini par l’utilisateur.

• TextConverter.TEXT_FIELD_HTML_FORMAT
• TextConverter.PLAIN_TEXT_FORMAT
• TextConverter.TEXT_LAYOUT_FORMAT

Si le format a été ajouté plusieurs fois, la première occurrence trouvée sera utilisée.

Paramètres

Eléments de l’API associés

package flashx.textLayout.conversion.examples
{
    import flashx.textLayout.conversion.ITextImporter;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.elements.TextFlow;
    
    public class getImporter_example 
    {
        public function importAndCheckErrors():TextFlow
        {
            var markup:String = "<TextFlow xmlns='http://ns.adobe.com/textLayout/2008'><p><span>Hello, World</span></p></TextFlow>";
            var importer:ITextImporter = TextConverter.getImporter(TextConverter.TEXT_LAYOUT_FORMAT);
            importer.throwOnError = false;
            var textFlow:TextFlow = importer.importToFlow(markup);
            if (!textFlow)
            {
                var errors:Vector.<String> = importer.errors;
                //deal with import errors
            }
            return textFlow;
        }
    }
}

Crée un objet TextFlow à partir de la source du contenu dans un format spécifié.

Utilisez l’une des constantes statiques fournies avec cette classe, un type MIME, pour spécifier le paramètre format, ou utilisez une valeur définie par l’utilisateur pour les importateurs enregistrés par l’utilisateur :

• TextConverter.TEXT_FIELD_HTML_FORMAT
• TextConverter.PLAIN_TEXT_FORMAT
• TextConverter.TEXT_LAYOUT_FORMAT

Paramètres

Eléments de l’API associés

Supprimez le format. Si un format a été ajouté plusieurs fois, seul le premier format trouvé est supprimé.

Paramètres

Supprimez le format à l’emplacement de l’index.

Paramètres

Format texte. Utilisez-le pour créer un objet TextFlow à partir d’une simple chaîne non formatée ou pour créer une simple chaîne non formatée à partir d’un objet TextFlow.

Format HTML. Utilisez-le pour l’importation à partir d’un TextFlow ou l’exportation vers un TextFlow en utilisant le format HTML. Text Layout Framework HTML prend en charge un sous-ensemble de balises et d’attributs pris en charge par la classe TextField du package flash.text.

Le tableau suivant répertorie les attributs et les balises HTML pris en charge pour les processus d’importation et d’exportation (les balises et attributs pris en charge par l’objet TextField, mais pas par Text Layout Framework sont spécifiquement décrits comme non pris en charge) :

Lorsqu’une balise inconnue est importée, l’importateur textFieldHTMLFormat définira une propriété unique typeName de FlowElement pour le nom de cette balise ou créera un objet DivElement ou SubParagraphGroupElement avec sa propriété typeName définie sur le nom de la balise.

L’exportateur textFieldHTMLFormat exportera typeName en tant que balise XML lorsque sa valeur diffère de la valeur par défaut.

Eléments de l’API associés

TextLayout Format. Utilisez-le pour l’importation à partir d’un TextFlow ou l’exportation vers un TextFlow en utilisant le format de balisage TextLayout. Le format de mise en forme de texte détectera les erreurs suivantes :

• Espace inattendu
• Elément inconnu
• Attribut inconnu

Cet exemple illustre une utilisation possible de la classe de conversion TextConverter. Le texte dans un format de balisage standard est importé dans un objet TextFlow, puis affiché. Le texte est ensuite exporté au format XML.

package flashx.textLayout.conversion.examples 
{
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.conversion.ConversionType;

    public class TextConverter_example extends Sprite
    {
        public function TextConverter_example()
        {
            var markup:String = "<TextFlow xmlns='http://ns.adobe.com/textLayout/2008'><p><span>Hello, World</span></p></TextFlow>";
            var textFlow:TextFlow = TextConverter.importToFlow(markup, TextConverter.TEXT_LAYOUT_FORMAT);
            textFlow.flowComposer.addController(new ContainerController(this, 200, 50));
            textFlow.flowComposer.updateAllControllers();
            //export to XML
            var xmlOut:XML = TextConverter.export(textFlow,TextConverter.TEXT_LAYOUT_FORMAT, ConversionType.XML_TYPE) as XML;
        }
    }
}