ITextImporter  - AS3

Die configuration-Eigenschaft enthält die IConfiguration-Instanz, die das Importprogramm beim Erstellen neuer TextFlow-Instanzen benötigt. Für diese Eigenschaft ist anfänglich der Wert null festgelegt.

Verwandte API-Elemente

Diese Eigenschaft enthält einen Vektor von Fehlermeldungen in Form von Strings nach dem Aufruf einer Importprogrammmethode, wenn für die throwOnError-Eigenschaft der Wert false (Standardwert) festgelegt wurde. Wenn keine Fehler aufgetreten sind, gibt die Eigenschaft null zurück. Die Eigenschaft wird jedes Mal, wenn die Methode aufgerufen wird, zurückgesetzt.

Die throwOnError-Eigenschaft steuert, wie das Importprogramm Fehler verarbeitet. Wenn true festgelegt ist, gibt die Methode eine Error-Instanz für Fehler aus. Wenn false (der Standardwert) angegeben wird, werden die Fehler in einem Vektor von Strings gesammelt und in der errors-Eigenschaft gespeichert und das Importprogramm gibt keine Fehler aus.

Steuert, ob das Importprogramm die für die Zwischenablage erforderlichen zusätzlichen Informationen bearbeiten soll. Daten, die aus der Zwischenablage eingehen, können unvollständige Absätze enthalten, d.h. Absätze, bei denen das Zeichen für den Abschluss oder eine neue Zeile fehlt. Wenn für useClipboardAnnotations der Wert true festgelegt wurde, sollte das Importprogramm diese unvollständigen Absätze mit ConverterBase.MERGE_TO_NEXT_PASTE für das Attribut markieren. Dadurch wird der Absatz beim Einfügen erwartungsgemäß mit dem Text zusammengeführt. Dasselbe gilt für list- oder div-Elemente, die diesen Absatz enthalten.

Verwandte API-Elemente

Importieren Sie Textinhalt aus einer externen Quelle und konvertieren ihn in einen TextFlow.

Parameter

Dieses Codefragment zeigt die Verwendung der ITextImporter-Methode, um wiederholte Importe formatierten Texts durchzuführen. Beachten Sie, dass Fehler zu Beginn jedes Aufrufs von importToFlow gelöscht werden.

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