TextConverter  - AS3

Número de formatos.

Registre un nuevo formato para la importación/exportación. El nuevo formato se añadirá al final, como la prioridad más baja. La ubicación puede ser importante para los clientes que tienen múltiples opciones sobre el formato que utilizar, como al importar desde un portapapeles externo. El nuevo formato puede admitir importación y/o exportación. Si el formato ya se ha añadido, a continuación, estará presente en varias ubicaciones. Se utilizará el primero encontrado.

Parámetros

Registre un nuevo formato para la importación/exportación en la ubicación especificada. La ubicación puede ser importante para los clientes que tienen múltiples opciones sobre el formato que utilizar, como al importar desde un portapapeles externo. Números más pequeños indican una mayor prioridad; estos convertidores se utilizarán primero. El nuevo formato puede admitir importación y/o exportación. Si el formato ya se ha añadido, a continuación, estará presente en varias ubicaciones. Se utilizará el primero encontrado.

Parámetros

Exporta un objeto TextFlow a un formato especificado.

Utilice una de las constantes estáticas suministradas con esta clase, un tipo MIME, o un formato definido por el usuario para que los exportadores definidos por el usuario especifiquen el parámetro format:

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

Especifique el tipo de los datos exportados en el parámetro conversionType con una de las constantes estáticas suministradas por la clase ConversionType o un tipo de datos definido por el usuario para exportadores definidos por el usuario:

• ConversionType.STRING_TYPE
• ConversionType.XML_TYPE

Parámetros

Elementos de API relacionados

Crea y devuelve un conversor de exportación que, posteriormente, se puede para exportar desde un objeto TextFlow a una cadena de origen o a un objeto XML. Utilice esta función si necesita realizar varias exportaciones por separado. Equivale a llamar a flashx.textLayout.conversion.TextConverter.export().

Utilice una de las constantes estáticas suministradas con esta clase para especificar el parámetro format:

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

Si el formato se ha añadido varias veces, se utilizará el primero encontrado.

Parámetros

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

Devuelve el nombre de formato para el formato del enésimo índice.

Parámetros

Devuelve FormatDescriptor para el formato del enésimo índice.

Parámetros

Crea y devuelve un convertidor de importación, que se puede utilizar para importar desde una cadena de origen, un objeto XML o cualquier formatos de datos definido por el usuario a un objeto TextFlow. Utilice este método si necesita realizar varias importaciones o si quiere gestionar los errores durante la importación. equivale a llamar a flashx.textLayout.conversion.TextConverter.importToFlow().

Utilice una de las constantes estáticas suministradas con esta clase para especificar el parámetro format, un tipo MIME o un formato de datos definido por el usuario.

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

Si el formato se ha añadido varias veces, se utilizará el primero encontrado.

Parámetros

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

Crea un objeto TextFlow desde el contenido de origen en un formato especificado.

Utilice una de las constantes estáticas suministradas con esta clase, un tipo MIME, para especificar el parámetro format o para utilizar un valor definido por el usuario para importadores registrados por usuarios:

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

Parámetros

Elementos de API relacionados

Elimina el formato. Si un formato se ha añadido varias veces, solo se eliminará la primera instancia encontrada.

Parámetros

Elimina el formato en la ubicación de índice.

Parámetros

Formato de texto normal. Utilice esto para crear un objeto TextFlow a partir de una cadena sencilla y sin formato o para crear una cadena sencilla y sin formato a partir de un objeto TextFlow.

Formato HTML. Utilice esto para importar o exportar desde y a un objeto TextFlow con formato HTML. El HTML de Text Layout Framework admite un subconjunto de etiquetas y atributos admitidos por la clase TextField en el paquete flash.text.

La siguiente tabla muestra los atributos y etiquetas HTML compatibles con el proceso de importación y exportación (las etiquetas y atributos admitidos por TextField, pero no admitidos por Text Layout Framework se describen específicamente como no admitidas):

Cuando se importa una etiqueta desconocida, el importador textFieldHTMLFormat define una sola propiedad typeName del objeto FlowElement a dicho nombre de etiqueta o crea un elemento DivElement o un elemento SubParagraphGroupElement con su propiedad typeName establecida en el nombre de la etiqueta.

El exportador textFieldHTMLFormat exporta typeName como etiqueta XML cuando es distinto del predeterminado.

Elementos de API relacionados

Formato TextLayout. Utilice esto para importar o exportar desde y a un objeto TextFlow utilizando el formato de marcado TextLayout. El formato TextLayout detectará los errores siguientes:

• Espacios de nombres inesperados
• Elementos desconocidos
• Atributos desconocidos

Este ejemplo muestra un uso de la clase de conversión TextConverter. El texto en formato de marcado estándar se importa a un objeto TextFlow y, seguidamente, se visualiza. Luego el texto se exporta en 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;
        }
    }
}