TextConverter  - AS3

Anzahl von Formaten.

Registriert ein neues Format für den Import/Export. Das neue Format wird am Ende hinzugefügt und erhält die niedrigste Priorität. Der Speicherort kann wichtig für Clients sein, die mehrere Formate z. B. für das Importieren aus der externen Zwischenablage zur Auswahl bereitstellen. Das neue Format unterstützt ggf. Import- und/oder Exportfunktionen. Wenn das Format bereits hinzugefügt wurde, ist es an verschiedenen Speicherorten vorhanden. Das Format, das als Erstes gefunden wird, wird verwendet.

Parameter

Registriert am angegebenen Speicherort ein neues Format für Import/Export. Der Speicherort kann wichtig für Clients sein, die mehrere Formate z. B. für das Importieren aus der externen Zwischenablage zur Auswahl bereitstellen. Konverter mit niedrigen Nummern haben eine höhere Priorität und werden zuerst ausprobiert. Das neue Format unterstützt ggf. Import- und/oder Exportfunktionen. Wenn das Format bereits hinzugefügt wurde, ist es an verschiedenen Speicherorten vorhanden. Das Format, das als Erstes gefunden wird, wird verwendet.

Parameter

Exportiert einen TextFlow in ein angegebenes Format.

Legen Sie mithilfe einer der in dieser Klasse bereitgestellten statischen Konstanten, eines MIME-Typs oder eines benutzerdefinierten Formats für benutzerdefinierte Exportprogramme den format-Parameter fest:

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

Legen Sie den Typ der Exportdaten im conversionType-Parameter mithilfe einer der durch die ConversionType-Klasse bereitgestellten statischen Konstanten bzw. einen benutzerdefinierten Datentyp für benutzerdefinierte Exportprogramme fest:

• ConversionType.STRING_TYPE
• ConversionType.XML_TYPE

Parameter

Verwandte API-Elemente

Erstellt einen Exportkonverter und gibt ihn zurück. Diesen können Sie anschließend für den Export aus einem TextFlow in einen Quellstring oder ein XML-Objekt verwenden. Verwenden Sie diese Funktion, wenn Sie viele separate Exporte durchführen müssen. Dies entspricht dem Aufrufen von flashx.textLayout.conversion.TextConverter.export().

Mit einer der in dieser Klasse bereitgestellten statischen Konstanten können Sie den format-Parameter angeben:

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

Wenn das Format mehrere Male hinzugefügt wurde, wird das Format verwendet, das als Erstes gefunden wird.

Parameter

Verwandte API-Elemente

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

Gibt den Formatnamen für das index'th-Format zurück.

Parameter

Gibt den FormatDescriptor für das index'th-Format zurück.

Parameter

Erstellt einen Importkonverter und gibt ihn zurück. Diesen können Sie anschließend für den Import aus einem Quellstring, einem XML-Objekt oder beliebigen benutzerdefinierten Datenformaten in einen TextFlow verwenden. Verwenden Sie diese Methode, wenn Sie viele separate Importe durchführen müssen oder Fehler während des Imports verarbeiten möchten. Dies entspricht dem Aufrufen von flashx.textLayout.conversion.TextConverter.importToFlow().

Mithilfe der in dieser Klasse bereitgestellten statischen Konstanten können Sie den format-Parameter, einen MIME-Typ oder ein benutzerdefiniertes Datenformat angeben.

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

Wenn das Format mehrere Male hinzugefügt wurde, wird das Format verwendet, das als Erstes gefunden wird.

Parameter

Verwandte API-Elemente

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

Erstellt einen TextFlow aus Quellinhalt in einem angegebenen Format.

Legen Sie mithilfe einer der in dieser Klasse bereitgestellten statischen Konstanten, eines MIME-Typs, den format-Parameter fest oder verwenden Sie einen benutzerdefinierten Wert für vom Benutzer registrierte Importprogramme:

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

Parameter

Verwandte API-Elemente

Entfernt das Format. Wenn ein Format mehrfach hinzugefügt wurde, wird nur die erste gefundene Instanz entfernt.

Parameter

Entfernt das Format an der Indexposition.

Parameter

Nur-Text-Format. Verwenden Sie dies zum Erstellen eines TextFlow aus einem einfachen, unformatierten String oder zum Erstellen eines einfachen, unformatierten Strings aus einem TextFlow.

HTML-Format. Verwenden Sie dies zum Importieren aus oder Exportieren in einen TextFlow mithilfe des HTML-Fomats. Das Text Layout Framework HTML unterstützt einen Teil der Tags und Attribute, die von der TextField-Klasse im flash.text-Paket unterstützt werden.

In der folgenden Tabelle werden die HTML-Tags und Attribute aufgeführt, die beim Importieren und Exportieren unterstützt werden (Tags und Attribute, die von TextField, jedoch nicht von Text Layout Framework unterstützt werden, gelten als nicht unterstützt):

Wenn ein unbekanntes Tag importiert wird, legt das textFieldHTMLFormat -Importprogramm entweder den Namen dieses Tags für die typeName-Eigenschaft eines einzelnen FlowElement fest oder erstellt ein DivElement oder ein SubParagraphGroupElement und legt den Namen des Tags für dessen typeName-Eigenschaft fest.

Das textFieldHTMLFormat-Exportprogramm exportiert typeName als das XML-Tag, wenn ein anderer als der Standardwert angegeben wurde.

Verwandte API-Elemente

TextLayout-Format. Verwenden Sie dies zum Importieren aus oder Exportieren in einen TextFlow mithilfe des TextLayout-Markup-Formats. Das Text Layout-Format erkennt die folgenden Fehler:

• Unerwarteter Namespace
• Unbekanntes Element
• Unbekanntes Attribut

Dieses Beispiel zeigt die Verwendung der TextFilter-Konvertierungsklasse. Text in einem Standard-Markup-Format wird in ein TextFlow-Objekt importiert und anschließend angezeigt. Der Text wird anschließend in das XML-Format exportiert.

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