패키지 | flashx.textLayout.conversion |
클래스 | public class TextConverter |
상속 | TextConverter Object |
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
변환된 데이터의 형식은 미리 정의되지 않습니다. 사용자가 작성한 변환기는 어떤 형식을 선택하든 자유롭게 사용하고 반환할 수 있습니다. 자주 사용되는 형식은 문자열, XML 및 ByteArray 인스턴스입니다. 변환기 작성자는 어떤 형식이 지원되는지 문서화해야 합니다.
기타 예제
속성 | 정의 주체 | ||
---|---|---|---|
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
numFormats : int [정적] [읽기 전용] 형식 수입니다. | TextConverter |
메서드 | 정의 주체 | ||
---|---|---|---|
[정적]
새 가져오기/내보내기 형식을 등록합니다. | TextConverter | ||
addFormatAt(index:int, format:String, importerClass:Class, exporterClass:Class = null, clipboardFormat:String = null):void [정적]
지정된 위치에 새 가져오기/내보내기 형식을 등록합니다. | TextConverter | ||
[정적]
TextFlow를 지정된 형식으로 내보냅니다. | TextConverter | ||
[정적]
나중에 TextFlow에서 소스 문자열 또는 XML 객체로 내보낼 때 사용할 수 있는 내보내기 변환기를 생성하여 반환합니다. | TextConverter | ||
[정적] 인덱스 형식의 이름을 반환합니다. | TextConverter | ||
[정적] 인덱스 형식의 FormatDescriptor를 반환합니다. | TextConverter | ||
[정적]
소스 문자열, XML 객체 또는 사용자 정의 데이터 형식에서 TextFlow로 가져올 때 사용할 수 있는 가져오기 변환기를 생성하여 변환합니다. | TextConverter | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
importToFlow(source:Object, format:String, config:IConfiguration = null):flashx.textLayout.elements:TextFlow [정적]
소스 내용에서 지정된 형식으로 TextFlow를 만듭니다. | TextConverter | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
[정적]
형식을 제거합니다. | TextConverter | ||
[정적]
인덱스 위치에서 형식을 제거합니다. | TextConverter | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object |
상수 | 정의 주체 | ||
---|---|---|---|
PLAIN_TEXT_FORMAT : String = "plainTextFormat" [정적]
일반 텍스트 형식입니다. | TextConverter | ||
TEXT_FIELD_HTML_FORMAT : String = "textFieldHTMLFormat" [정적]
HTML 형식입니다. | TextConverter | ||
TEXT_LAYOUT_FORMAT : String = "textLayoutFormat" [정적]
TextLayout 형식입니다. | TextConverter |
numFormats | 속성 |
addFormat | () | 메서드 |
public static function addFormat(format:String, importerClass:Class, exporterClass:Class, clipboardFormat:String):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
새 가져오기/내보내기 형식을 등록합니다. 새 형식이 마지막에 가장 낮은 우선 순위로 추가됩니다. 외부 클립보드에서 가져오는 경우와 같이, 사용 형식에 대해 여러 옵션이 있는 클라이언트에는 위치가 중요할 수 있습니다. 새 형식이 가져오기 및/또는 내보내기를 지원할 수 있습니다. 이미 형식이 추가되었으면 여러 위치에 저장됩니다. 제일 먼저 발견되는 것을 사용합니다.
매개 변수
format:String — 등록할 가져오기 변환기 클래스 또는 null입니다.
| |
importerClass:Class — 등록할 내보내기 변환기 클래스 또는 null입니다.
| |
exporterClass:Class — 변환기 클래스에 태그를 지정하는 형식 문자열입니다. 형식은 어떤 이름이든 될 수 있지만 고유해야 합니다.
| |
clipboardFormat:String — 클립보드에서 또는 클립보드로 변환할 때 클립보드 형식으로 사용되는 문자열입니다. 형식이 클립보드 액세스를 지원하지 않으면 null로 설정합니다.
|
addFormatAt | () | 메서드 |
public static function addFormatAt(index:int, format:String, importerClass:Class, exporterClass:Class = null, clipboardFormat:String = null):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
지정된 위치에 새 가져오기/내보내기 형식을 등록합니다. 외부 클립보드에서 가져오는 경우와 같이, 사용 형식에 대해 여러 옵션이 있는 클라이언트에는 위치가 중요할 수 있습니다. 숫자가 낮을수록 우선 순위가 높습니다. 숫자가 낮은 변환기를 먼저 시도합니다. 새 형식이 가져오기 및/또는 내보내기를 지원할 수 있습니다. 이미 형식이 추가되었으면 여러 위치에 저장됩니다. 제일 먼저 발견되는 것을 사용합니다.
매개 변수
index:int — 등록할 가져오기 변환기 클래스 또는 null입니다.
| |
format:String — 등록할 내보내기 변환기 클래스 또는 null입니다.
| |
importerClass:Class — 변환기 클래스에 태그를 지정하는 형식 문자열입니다.
| |
exporterClass:Class (default = null ) — 클립보드에서 또는 클립보드로 변환할 때 클립보드 형식으로 사용되는 문자열입니다. 형식이 클립보드 액세스를 지원하지 않으면 null로 설정합니다.
| |
clipboardFormat:String (default = null )
|
export | () | 메서드 |
public static function export(source:flashx.textLayout.elements:TextFlow, format:String, conversionType:String):Object
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
TextFlow를 지정된 형식으로 내보냅니다.
사용자 정의 내보내기 도구가 format
매개 변수를 지정할 때 이 클래스로 제공되는 정적 상수 중 하나, MIME 유형 또는 사용자 정의 형식을 사용합니다.
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
ConversionType 클래스를 통해 제공되는 정적 상수 중 하나 또는 사용자 정의 내보내기 도구의 사용자 정의 데이터 유형을 사용하여 내보내는 데이터 형식을 conversionType
매개 변수에 지정합니다.
- ConversionType.STRING_TYPE
- ConversionType.XML_TYPE
매개 변수
source:flashx.textLayout.elements:TextFlow — 소스 내용입니다.
| |
format:String — 출력 형식입니다.
| |
conversionType:String — 내보낸 데이터의 유형입니다.
|
Object — TextFlow에서 가져온 객체입니다.또는 오류 발생 시 null입니다.
|
관련 API 요소
getExporter | () | 메서드 |
public static function getExporter(format:String):flashx.textLayout.conversion:ITextExporter
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
나중에 TextFlow에서 소스 문자열 또는 XML 객체로 내보낼 때 사용할 수 있는 내보내기 변환기를 생성하여 반환합니다. 수행할 별개의 내보내기가 많은 경우 이 함수를 사용합니다. flashx.textLayout.conversion.TextConverter.export()
를 호출하는 것과 같습니다.
이 클래스와 함께 제공된 정적 상수 중 하나를 사용하여 format
매개 변수를 지정합니다.
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
형식이 여러 번 추가되면 처음 발견된 형식이 사용됩니다.
매개 변수
format:String — 내보낸 데이터의 대상 형식입니다.
|
flashx.textLayout.conversion:ITextExporter — 지정된 형식으로 내보낼 수 있는 ITextExporter 텍스트 변환기입니다.
|
관련 API 요소
예제 ( 예제 사용 방법 )
이 코드 단편은 getExporter
메서드를 사용하여 서식 있는 텍스트 내보내기를 반복적으로 수행하는 것을 보여 줍니다.
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; } } }
getFormatAt | () | 메서드 |
getFormatDescriptorAt | () | 메서드 |
public static function getFormatDescriptorAt(index:int):FormatDescriptor
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
인덱스 형식의 FormatDescriptor를 반환합니다.
매개 변수
index:int |
FormatDescriptor |
getImporter | () | 메서드 |
public static function getImporter(format:String, config:IConfiguration = null):flashx.textLayout.conversion:ITextImporter
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
소스 문자열, XML 객체 또는 사용자 정의 데이터 형식에서 TextFlow로 가져올 때 사용할 수 있는 가져오기 변환기를 생성하여 변환합니다. 별도의 가져오기를 많이 수행해야 하거나 가져오기 동안 오류를 처리하려면 이 메서드를 사용합니다. flashx.textLayout.conversion.TextConverter.importToFlow()
를 호출하는 것과 같습니다.
이 클래스를 통해 제공되는 정적 상수 중 하나를 사용하여 format
매개 변수, MIME 유형 또는 사용자 정의 데이터 형식을 지정합니다.
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
형식이 여러 번 추가되면 처음 발견된 형식이 사용됩니다.
매개 변수
format:String — 소스 내용의 형식입니다. flashx.textLayout.conversion.TextConverter.TEXT_LAYOUT_FORMAT, PLAIN_TEXT_FORMAT, TEXT_FIELD_HTML_FORMAT 등의 상수, MIME 유형 또는 사용자 정의 형식을 사용합니다.
| |
config:IConfiguration (default = null ) — 이 가져오기 동안 사용할 구성입니다. null은 현재 기본값을 사용함을 의미합니다. ITextImporter.configuration 속성을 사용하여 구성을 설정할 수도 있습니다.
|
flashx.textLayout.conversion:ITextImporter — 소스 데이터를 가져올 수 있는 ITextImporter 텍스트 가져오기 도구입니다.
|
관련 API 요소
예제 ( 예제 사용 방법 )
이 코드 단편은 getImporter
메서드를 사용하여 서식 있는 텍스트 가져오기를 반복적으로 수행하는 것을 보여 줍니다. 각각의 importToFlow
호출 시작 부분에서 오류가 제거되는 것에 유의합니다.
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; } } }
importToFlow | () | 메서드 |
public static function importToFlow(source:Object, format:String, config:IConfiguration = null):flashx.textLayout.elements:TextFlow
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
소스 내용에서 지정된 형식으로 TextFlow를 만듭니다.
이 클래스를 통해 제공되는 정적 상수 중 하나 또는 MIME 유형을 사용하여 format
매개 변수를 지정하거나 사용자가 등록한 가져오기 도구의 경우 사용자 정의 값을 사용합니다.
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
매개 변수
source:Object — 소스 내용입니다.
| |
format:String — 소스 내용의 형식입니다.
| |
config:IConfiguration (default = null ) — 새 TextFlow를 만들 때 사용할 IConfiguration입니다.
|
flashx.textLayout.elements:TextFlow — 소스에서 생성된 TextFlow 또는 오류 발생 시 null입니다.
|
관련 API 요소
removeFormat | () | 메서드 |
removeFormatAt | () | 메서드 |
PLAIN_TEXT_FORMAT | 상수 |
public static const PLAIN_TEXT_FORMAT:String = "plainTextFormat"
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
일반 텍스트 형식입니다. 간단한 서식 없는 문자열에서 TextFlow를 만들거나 TextFlow에서 간단한 서식 없는 문자열을 만들 때 사용합니다.
TEXT_FIELD_HTML_FORMAT | 상수 |
public static const TEXT_FIELD_HTML_FORMAT:String = "textFieldHTMLFormat"
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
HTML 형식입니다. HTML 형식을 사용하여 TextFlow에서 가져오거나 TextFlow로 내보낼 때 사용합니다. Text Layout Framework HTML은 flash.text
패키지의 TextField 클래스에서 지원하는 태그 및 특성 중 일부를 지원합니다.
다음 표에는 가져오기 및 내보내기 프로세스에 대해 지원되는 HTML 태그와 특성이 나와 있습니다. TextField에서는 지원하지만 Text Layout Framework에서는 지원하지 않는 태그와 특성은 지원되지 않는 것으로 설명되어 있습니다.
태그 | 설명 |
---|---|
앵커 태그 |
<a> 태그는 하이퍼링크를 만들며 다음 특성을 지원합니다.
|
굵게 태그 |
<b> 태그는 텍스트를 굵은 글꼴로 렌더링합니다. 이때 사용된 글꼴이 굵은 글꼴을 지원해야 합니다.
|
행 분리 태그 |
<br> 태그는 텍스트에서 줄을 바꿉니다.
|
글꼴 태그 |
<font> 태그는 텍스트를 표시할 글꼴 또는 글꼴 목록을 지정합니다. 지원되는 특성은 다음과 같습니다.
|
이미지 태그 |
<img> 태그를 사용하면 외부 이미지 파일(JPEG, GIF, PNG), SWF 파일 및 동영상 클립을 텍스트 내에 포함할 수 있습니다.
참고: TextField 클래스와 달리, |
기울임체 태그 |
<i> 태그는 대상 텍스트를 기울임체로 표시합니다. 이때 사용된 글꼴이 기울임체를 지원해야 합니다.
|
목록 항목 태그 | 참고: TextField 클래스와 달리, 목록 항목 태그는 지원되지 않습니다. |
단락 태그 |
<p> 태그는 새로운 단락을 만듭니다. <p> 태그는 다음 특성을 지원합니다.
|
span 태그 |
<span> 태그는 다음 특성을 지원합니다.
|
텍스트 서식 태그 |
|
밑줄 태그 |
<u> 태그는 대상 텍스트에 밑줄을 긋습니다.
|
가져온 태그가 알 수 없는 태그인 경우 textFieldHTMLFormat
가져오기 도구는 단일 FlowElement의 typeName 속성을 해당 태그 이름으로 설정하거나 typeName 속성을 태그 이름으로 설정한 상태로 DivElement 또는 SubParagraphGroupElement를 만듭니다.
기본값과 다르면 textFieldHTMLFormat
내보내기 도구가 typeName
을 XML 태그로 내보냅니다.
관련 API 요소
TEXT_LAYOUT_FORMAT | 상수 |
public static const TEXT_LAYOUT_FORMAT:String = "textLayoutFormat"
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
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; } } }
Tue Jun 12 2018, 03:17 PM Z