| 패키지 | 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
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시