TextConverter  - AS3

Número de formatos.

Registre um novo formato para importação/exportação. O novo formato será adicionado no fim, como a menor prioridade. O local pode ser significativo para clientes que têm várias escolhas para qual formato usar, como ao importar da área de transferência externa. O novo formato pode ser compatível com importação e/ou exportação. O formato estará presente em vários locais se já tiver sido adicionado. O primeiro localizado será usado.

Parâmetros

Registre um novo formato para importar/exportar no local especificado. O local pode ser significativo para clientes que têm várias escolhas para qual formato usar, como ao importar da área de transferência externa. Números menores indicam maior prioridade; esses conversores serão tentados primeiro. O novo formato pode ser compatível com importação e/ou exportação. O formato estará presente em vários locais se já tiver sido adicionado. O primeiro localizado será usado.

Parâmetros

Exporta um TextFlow em um formato específico.

Use uma das constantes estáticas fornecidas com esta classe, um tipo de MIME, ou um formato definido pelo usuário de exportadores definidos pelo usuário para especificar o parâmetro format:

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

Especifique o tipo dos dados exportados no parâmetro conversionType com uma das constantes estáticas fornecidas pela classe ConversionType, ou pelo tipo de dados definido pelo usuário de exportadores definidos pelo usuário:

• ConversionType.STRING_TYPE
• ConversionType.XML_TYPE

Parâmetros

Elementos da API relacionados

Cria e retorna um conversor de exportação que pode ser usado para exportar de um TextFlow para uma sequência de caracteres de origem ou um objeto XML. Use esta função se precisar realizar várias exportações separadas. Equivale a chamar flashx.textLayout.conversion.TextConverter.export().

Use uma das constantes estáticas fornecidas com esta classe para especificar o parâmetro format:

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

Se o formato tiver sido adicionado várias vezes, o primeiro localizado será usado.

Parâmetros

Elementos da API relacionados

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

Retorna o nome de formato para o formato em índice.

Parâmetros

Retorna o FormatDescriptor para o formato em índice.

Parâmetros

Cria e retorna um conversor de importação, que pode ser usado para importar de uma sequência de caracteres de origem, um objeto de XML, ou qualquer formato de dados definido pelo usuário para um TextFlow. Use este método caso seja necessário realizar muitas importações separadas, ou se quiser corrigir erros durante a importação. Equivale a chamar flashx.textLayout.conversion.TextConverter.importToFlow().

Use uma das constantes estáticas fornecidas com esta classe para especificar o parâmetro format, um tipo de MIME, ou um formato de dados definido pelo usuário.

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

Se o formato tiver sido adicionado várias vezes, o primeiro localizado será usado.

Parâmetros

Elementos da API relacionados

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

Cria um TextFlow do conteúdo de origem em um formato especificado.

Use uma das constantes estáticas fornecidas com esta classe, um tipo de MIME, para especificar o parâmetro format, ou use um valor definido pelo usuário para importadores registrados pelo usuário:

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

Parâmetros

Elementos da API relacionados

Remova o formato. Se um formato foi adicionado várias vezes, só o primeiro localizado é removido.

Parâmetros

Remova o formato no local de índice.

Parâmetros

Formato de texto simples. Utilize-o para criar um TextFlow a partir de uma string simples sem formatação, ou para criar uma string simples sem formatação a partir de um TextFlow.

Formato HTML. Utilize-o para importar de ou exportar para um TextFlow usando o formato HTML. O HTML de Estrutura de Layout de texto suporta um subconjunto de marcas e atributos suportados pela classe TextField no pacote flash.text.

A seguinte tabela enumera as marcas de HTML e atributos suportados para o processo de importação e exportação (marcas e atributos suportados por TextField, mas não suportados pela Estrutura de Layout de texto são especificamente descritos como não suportados):

Quando uma marca desconhecida é importada, o importador textFieldHTMLFormat definirá a propriedade typeName de um FlowElement único naquele nome da marca ou criará um DivElement ou um SubParagraphGroupElement com seu conjunto de propriedades typeName ao nome da marca.

O exportador textFieldHTMLFormat exportará typeName como a marca XML quando for diferente do padrão.

Elementos da API relacionados

Formato TextLayout. Utilize-o para importar de ou exportar para um TextFlow usando o formato de marcação TextLayout. O formato Text Layout detecta os seguintes erros:

• Namespace inesperado
• Elemento desconhecido
• Atributo desconhecido

Este exemplo mostra uma utilização da classe de conversão TextConverter. O texto em um formato padrão de marcação é importado para um objeto TextFlow e, depois, exibido. Então, o texto é exportado no 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;
        }
    }
}