TextConverter  - AS3

Numero di formati.

Registrate un nuovo formato per l'importazione/esportazione. Il nuovo formato verrà aggiunto alla fine, con la priorità più bassa. La posizione può essere rilevante per i client che presentano più scelte per il formato da utilizzare, ad esempio per l'importazione dagli Appunti esterni. Il nuovo formato potrebbe supportare l'importazione e/o l'esportazione. Se il formato è già stato aggiunto, sarà presente in più posizioni. Verrà utilizzato il primo formato trovato.

Parametri

Registrate un nuovo formato per l'importazione/esportazione, nella posizione specificata. La posizione può essere rilevante per i client che presentano più scelte per il formato da utilizzare, ad esempio per l'importazione dagli Appunti esterni. I numeri inferiori indicano una priorità maggiore; questi convertitori devono essere provati per primi. Il nuovo formato potrebbe supportare l'importazione e/o l'esportazione. Se il formato è già stato aggiunto, sarà presente in più posizioni. Verrà utilizzato il primo formato trovato.

Parametri

Esporta un oggetto TextFlow in un formato specificato.

Per specificare il parametro format, utilizzate una delle quattro costanti statiche fornite con questa classe, un tipo MIME oppure un formato definito dall'utente per gli esportatori definiti dall'utente.

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

Specificate il tipo dei dati esportati nel parametro conversionType con una delle costanti statiche fornite dalla classe ConversionType, oppure un tipo di dati definito dall'utente per gli esportatori definiti dall'utente:

• ConversionType.STRING_TYPE
• ConversionType.XML_TYPE

Parametri

Elementi API correlati

Crea e restituisce un convertitore di esportazione, che potrete quindi utilizzare per l'esportazione da un oggetto TextFlow in una stringa di origine o in un oggetto XML. Utilizzate questa funzione se dovete eseguire molte esportazioni distinte. Equivale a una chiamata a flashx.textLayout.conversion.TextFilter.export().

Per specificare il parametro format, utilizzate una delle costanti statiche fornite con questa classe:

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

Se il formato è stato aggiunto più volte, verrà utilizzato il primo formato trovato.

Parametri

Elementi API correlati

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

Restituisce il nome di formato per il formato corrispondente al numero di indice.

Parametri

Restituisce il FormatDescriptor per il formato corrispondente al numero di indice.

Parametri

Crea e restituisce un convertitore di importazione, che potrete quindi utilizzare per l'importazione in un oggetto TextFlow da una stringa di origine, un oggetto XML o qualunque formato dati definito dall'utente. Utilizzate questo metodo se dovete eseguire molte importazioni distinte o se desiderate gestire gli errori durante l'importazione. Equivale a una chiamata a flashx.textLayout.conversion.TextConverter.importToFlow().

Per specificare il parametro format, utilizzate una delle costanti statiche fornite con questa classe, un tipo MIME o un formato dati definito dall'utente.

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

Se il formato è stato aggiunto più volte, verrà utilizzato il primo formato trovato.

Parametri

Elementi API correlati

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

Crea un oggetto TextFlow dal contenuto di origine in un formato specificato.

Per specificare il parametro format, utilizzate una delle costanti statiche fornite con questa classe oppure un valore definito dall'utente per gli importatori registrati dall'utente:

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

Parametri

Elementi API correlati

Rimuove il formato. Se un formato è stato aggiunto più volte, verrà rimosso solo il primo formato trovato.

Parametri

Rimuove il formato nella posizione di indice.

Parametri

Formato testo normale. Utilizzate questo filtro per la creazione di un oggetto TextFlow da un semplice oggetto String non formattato o per la creazione di un semplice oggetto String non formattato da un oggetto TextFlow.

Formato HTML. Utilizzate questo filtro per l'importazione da, o l'esportazione in, un oggetto TextFlow utilizzando il formato HTML. L'HTML Text Layout Framework HTML supporta un sottoinsieme di tag e attributi supportati dalla classe TextField nel pacchetto flash.text.

Nella seguente tabella sono elencati i tag e gli attributi HTML supportati per i processi di importazione ed esportazione (i tag e gli attributi supportati da TextField, ma non da Text Layout Framework sono espressamente indicati come non supportati):

Quando un tag sconosciuto viene importato, l'importatore textFieldHTMLFormat imposta una singola proprietà typeName del FlowElement su tale nome di tag oppure crea un DivElement o un SubParagraphGroupElement con la sua proprietà typeName impostata sul nome del tag.

L'esportatore textFieldHTMLFormat esporta typeName come tag XML quando è diverso dal valore predefinito.

Elementi API correlati

Formato TextLayout. Utilizzate questo filtro per l'importazione da, o l'esportazione in, un oggetto TextFlow utilizzando il formato codice TextLayout. Il formato TextLayout rileva i seguenti errori:

• Spazio dei nomi imprevisto
• Elemento sconosciuto
• Attributo sconosciuto

In questo esempio è descritto un utilizzo possibile della classe di conversione TextConverter. Il testo in un formato di codice standard viene importato nell'oggetto TextFlow e quindi visualizzato. Il testo viene quindi esportato nel formato 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;
        }
    }
}