TextConverter  - AS3

Aantal indelingen.

Registreer een nieuwe indeling voor importeren/exporteren. De nieuwe indeling wordt aan het einde toegevoegd, met de laagste prioriteit. Locatie kan significant zijn voor clients met meerdere mogelijkheden voor de te gebruiken indeling, bijvoorbeeld bij het importeren van het externe Klembord. De nieuwe indeling biedt mogelijk ondersteuning voor importeren en/of exporteren. Als de indeling al is toegevoegd, is deze op meerdere locaties aanwezig. De indeling die als eerste wordt gevonden, wordt gebruikt.

Parameters

Registreer een nieuwe indeling voor importeren/exporteren op de opgegeven locatie. Locatie kan significant zijn voor clients met meerdere mogelijkheden voor de te gebruiken indeling, bijvoorbeeld bij het importeren van het externe Klembord. Lagere getallen duiden op een hogere prioriteit. Deze converters worden eerst geprobeerd. De nieuwe indeling biedt mogelijk ondersteuning voor importeren en/of exporteren. Als de indeling al is toegevoegd, is deze op meerdere locaties aanwezig. De indeling die als eerste wordt gevonden, wordt gebruikt.

Parameters

Exporteert een TextFlow naar een opgegeven indeling.

Gebruik een van de statische constanten die worden verstrekt met deze klasse, een MIME-type of een door gebruikers gedefinieerde indeling voor door gebruikers gedefinieerde exporters om de parameter format op te geven:

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

Geef het type voor de geëxporteerde gegevens in de parameter conversionType op met een van de statische constanten verstrekt door de klasse ConversionType, of een door gebruikers gedefinieerd gegevenstype voor door gebruikers gedefinieerde exporters:

• ConversionType.STRING_TYPE
• ConversionType.XML_TYPE

Parameters

Verwante API-elementen

Maakt en retourneert een exportconverter die u vervolgens kunt gebruiken om gegevens uit een TextFlow te exporteren naar een brontekenreeks of een XML-object. Gebruik deze functie als u veel afzonderlijke exportacties moet uitvoeren. Equivalent aan het oproepen van flashx.textLayout.conversion.TextConverter.export().

U kunt de parameter format opgeven met een van de statische constanten die bij deze klasse horen:

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

Als de indeling meerdere keren is toegevoegd, wordt de eerste gevonden indeling gebruikt.

Parameters

Verwante API-elementen

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

Retourneert de indelingsnaam voor de indeling op indexpositie.

Parameters

Retourneert de FormatDescriptor voor de indeling op indexpositie.

Parameters

Maakt en retourneert een importconverter die u vervolgens kunt gebruiken voor het importeren van een brontekenreeks, een XML-object of door de gebruiker gedefinieerde gegevens naar een TextFlow. Gebruik deze methode als u veel afzonderlijke importacties moet uitvoeren of als u fouten tijdens het importeren wilt verwerken. Equivalent aan het oproepen van flashx.textLayout.conversion.TextConverter.importToFlow().

Gebruik een van de statische constanten uit deze klasse om de parameter format, een MIME-type of een door de gebruiker gedefinieerde indeling te definiëren.

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

Als de indeling meerdere keren is toegevoegd, wordt de eerste gevonden indeling gebruikt.

Parameters

Verwante API-elementen

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

Maakt een TextFlow van de broninhoud in een opgegeven indeling.

Gebruik een van de statische constanten die worden verstrekt met deze klasse, een MIME-type, om de parameter format aan te geven of gebruik een door gebruikers gedefinieerde waarde voor door gebruikers geregistreerde importers:

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

Parameters

Verwante API-elementen

Verwijder de opmaak. Als een indeling meerdere keren is toegevoegd, wordt alleen de eerste gevonden indeling verwijderd.

Parameters

Verwijder de indeling op de indexlocatie.

Parameters

Onbewerkte-tekstindeling. Te gebruiken voor het maken van een TextFlow op basis van een eenvoudige tekenreeks zonder opmaak of voor het maken van een eenvoudige tekenreeks zonder opmaak op basis van een TextFlow.

HTML-indeling. Te gebruiken voor het importeren uit of exporteren naar een TextFlow met de HTML-indeling. Text Layout Framework-HTML ondersteunt een subset van labels en kenmerken die worden ondersteund door de TextField-klasse in het flash.text-pakket.

De volgende tabel geeft de HTML-labels en -kenmerken weer die worden ondersteund voor het importeren en exporteren (labels en kenmerken ondersteund door TextField, maar niet door Text Layout Framework worden specifiek omschreven als niet ondersteund):

Wanneer een onbekende tag wordt geïmporteerd, stelt de textFieldHTMLFormat-importer de typeName-eigenschap van één FlowElement in op die tagnaam of maakt het een DivElement of SubParagraphGroupElement waarvoor de typeName-eigenschap is ingesteld op de tagnaam.

De exporter textFieldHTMLFormat exporteert typeName als de XML-tag wanneer deze afwijkt van de standaard.

Verwante API-elementen

TextLayout-indeling. Te gebruiken voor het importeren uit of exporteren naar een TextFlow met de TextLayout Markup-indeling. TextLayout-indeling zal de volgende fouten vaststellen:

• Onverwachte naamruimte
• Onbekend element
• Onbekend kenmerk

Dit voorbeeld illustreert een manier waarop de conversieklasse TextConverter kan worden gebruikt. Tekst in een standaardopmaakindeling wordt geïmporteerd in een TextFlow-object en vervolgens weergegeven. De tekst wordt vervolgens geëxporteerd naar XML-indeling.

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