TextConverter  - AS3

형식 수입니다.

새 가져오기/내보내기 형식을 등록합니다. 새 형식이 마지막에 가장 낮은 우선 순위로 추가됩니다. 외부 클립보드에서 가져오는 경우와 같이, 사용 형식에 대해 여러 옵션이 있는 클라이언트에는 위치가 중요할 수 있습니다. 새 형식이 가져오기 및/또는 내보내기를 지원할 수 있습니다. 이미 형식이 추가되었으면 여러 위치에 저장됩니다. 제일 먼저 발견되는 것을 사용합니다.

매개 변수

지정된 위치에 새 가져오기/내보내기 형식을 등록합니다. 외부 클립보드에서 가져오는 경우와 같이, 사용 형식에 대해 여러 옵션이 있는 클라이언트에는 위치가 중요할 수 있습니다. 숫자가 낮을수록 우선 순위가 높습니다. 숫자가 낮은 변환기를 먼저 시도합니다. 새 형식이 가져오기 및/또는 내보내기를 지원할 수 있습니다. 이미 형식이 추가되었으면 여러 위치에 저장됩니다. 제일 먼저 발견되는 것을 사용합니다.

매개 변수

TextFlow를 지정된 형식으로 내보냅니다.

사용자 정의 내보내기 도구가 format 매개 변수를 지정할 때 이 클래스로 제공되는 정적 상수 중 하나, MIME 유형 또는 사용자 정의 형식을 사용합니다.

• 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에서 가져오거나 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에서 가져오거나 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;
        }
    }
}