TextConverter  - AS3

格式的數目。

註冊匯入/匯出的新格式。新的格式會最後新增，因為其優先權最低。位置對於有多種可用格式選擇的用戶端來說非常重要，例如從外部剪貼簿匯入時。新的格式可支援匯入和/或匯出。如果已新增格式，則該格式會出現在多個位置中。將會使用找到的第一個。

參數

在指定位置註冊匯入/匯出的新格式。位置對於有多種可用格式選擇的用戶端來說非常重要，例如從外部剪貼簿匯入時。較小的數字代表較高的優先權，因為將先嘗試這些轉換器。新的格式可支援匯入和/或匯出。如果已新增格式，則該格式會出現在多個位置中。將會使用找到的第一個。

參數

將 TextFlow 匯出成指定的格式。

使用此類別提供的靜態常數之一、MIME 類型或使用者定義匯出器的使用者定義格式，來指定 format 參數：

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

使用 ConversionType 類別提供的靜態常數之一或使用者定義匯出器的使用者定義資料類型，來指定 conversionType 參數中的匯出資料類型：

• ConversionType.STRING_TYPE
• ConversionType.XML_TYPE

參數

相關 API 元素

建立並傳回匯出轉換器，然後您可以使用該轉換器從 TextFlow 匯出至來源字串或 XML 物件。如果您要執行許多個別的匯出作業，請使用此函數。其作用相當於呼叫 flashx.textLayout.conversion.TextConverter.export()。

使用此類別提供的靜態常數之一來指定 format 參數：

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

如果已多次新增格式，將會使用找到的第一個。

參數

相關 API 元素

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

傳回索引格式的格式名稱。

參數

傳回索引格式的 FormatDescriptor。

參數

建立並傳回匯入轉換器，然後您可以使用該轉換器從來源字串、XML 物件或任何使用者定義的資料格式匯入至 TextFlow。如果您要執行許多個別的匯入作業，或者您想在匯入時處理錯誤，請使用此方法。其作用相當於呼叫 flashx.textLayout.conversion.TextConverter.importToFlow()。

使用此類別提供的靜態常數之一來指定 format 參數、MIME 類型或使用者定義的資料格式。

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

如果已多次新增格式，將會使用找到的第一個。

參數

相關 API 元素

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

使用指定格式從來源內容建立 TextFlow。

使用此類別提供的靜態常數之一和 MIME 類型來指定 format 參數，或使用使用者註冊匯入器的使用者定義值。

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

參數

相關 API 元素

移除格式。如果多次新增格式，僅會移除找到的第一個。

參數

移除索引位置的格式。

參數

純文字格式。可用於從簡單、未格式化的字串建立 TextFlow，或用於從 TextFlow 建立簡單、未格式化的字串。

HTML 格式。可用來執行 HTML 格式之 TextFlow 的匯入或匯出。Text Layout Framework HTML 支援 flash.text 套件中 TextField 類別所支援標籤與特質的子集。

下列表格列出支援匯入與匯出過程的 HTML 標籤與特質 (TextField 支援的標籤與特質，但是 Text Layout Framework 不支援的標籤與特質將特別描述為不支援)：

將不明標籤匯入到 textFieldHTMLFormat 時，匯入器會將單一 FlowElement 的 typeName 屬性設定為該標籤名稱，或建立 typeName 屬性設為標籤名稱的 DivElement 或 SubParagraphGroupElement。

當不同於預設值時，textFieldHTMLFormat 匯出器會匯出 typeName 做為 XML 標籤。

相關 API 元素

TextLayout 格式。可用來執行 TextLayout 標記格式之 TextFlow 的匯入或匯出。「文字版面」格式會偵測以下錯誤：

• 未預期的名稱空間
• 不明的元素
• 不明的特質

此範例顯示 TextConverter 轉換類別的用法。標準標記格式的文字會匯入 TextFlow 物件，然後再顯示。接著文字會以 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;
        }
    }
}