ITextImporter  - AS3

La propriété configuration contient l’occurrence d’IConfiguration dont l’importateur a besoin lorsqu’il crée de nouvelles occurrences de TextFlow. Initialement, cette propriété est définie sur null.

Eléments de l’API associés

Cette propriété contient un vecteur de messages d’erreur en tant que chaînes après un appel à une méthode importer, si la propriété throwOnError est définie sur false, ce qui est la valeur par défaut. Si aucune erreur ne s’est produite, la propriété retourne null. La propriété est réinitialisée à chaque appel de méthode.

La propriété throwOnError contrôle la façon dont l’importateur gère les erreurs. Si elle est définie sur true, les méthodes génèrent une occurrence Error en cas d’erreurs. Si elle est définie sur false (valeur par défaut), les erreurs sont collectées dans un vecteur de chaînes et stockées dans la propriété errors, et l’importateur ne génère rien.

Contrôle si l’importateur doit gérer ou non les informations supplémentaires nécessaires pour le Presse-papiers. Lorsque les données proviennent du Presse-papiers, elles peuvent contenir des paragraphes partiels (paragraphes auxquels il manque le terminateur ou un caractère de nouvelle ligne). Si useClipboardAnnotations est défini sur true, l’importateur marque ces paragraphes partiels avec un attribut ConverterBase.MERGE_TO_NEXT_ON_PASTE. L’opération de collage peut ainsi correctement gérer la fusion du paragraphe collé (et de tous les éléments list ou div qu’il peut contenir) dans le texte.

Eléments de l’API associés

Importation de contenu de texte à partir d’une source externe et conversion de ce texte en objet TextFlow.

Paramètres

Ce fragment de code illustre une utilisation possible de la méthode ITextImporter en vue d’effectuer des importations répétées de texte formaté. Notez que les erreurs sont supprimées au début de chaque appel de importToFlow.

package flashx.textLayout.conversion.examples
{
    import flashx.textLayout.conversion.ITextImporter;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.elements.TextFlow;
    
    public class ITextImporterExample 
    {
        // Create a new TextFlow based on the markup string
        static 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;
        }
    }
}