패키지flash.text.engine
클래스public class ContentElement
상속ContentElement Inheritance Object
하위 클래스 GraphicElement, GroupElement, TextElement

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

ContentElement 클래스는 GroupElement에 나타날 수 있는 요소 유형(GraphicElement, 다른 GroupElement 또는 TextElement)에 대한 기본 클래스로 사용됩니다.

ContentElement는 추상 기본 클래스이므로 ContentElement를 직접 인스턴스화할 수 없습니다. new ContentElement()를 호출하면 ArgumentError 예외가 발생합니다.

ContentElement 요소는 정확히 하나의 GroupElement 또는 정확히 텍스트 블록 하나의 content 속성에만 할당할 수 있습니다.

참고 사항

ElementFormat
GraphicElement
GroupElement
TextBlock.content
TextElement
TextLineMirrorRegion
TextRotation


Public 속성
 속성다음에 의해 정의됨
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  elementFormat : ElementFormat
요소에 사용되는 ElementFormat 객체입니다.
ContentElement
  eventMirror : EventDispatcher
이 내용 요소에 기반을 둔 유효한 텍스트 행에 전달된 모든 이벤트의 복사본을 수신하는 EventDispatcher 객체입니다.
ContentElement
  groupElement : GroupElement
[읽기 전용] 이 요소를 포함하는 GroupElement입니다. 이 요소가 그룹에 포함되지 않은 경우에는 null입니다.
ContentElement
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  rawText : String
[읽기 전용] 요소에 있는 텍스트(U+FDEF 문자 포함)의 복사본입니다.
ContentElement
  text : String
[읽기 전용] 요소에 있는 텍스트(String의 그래픽 요소를 나타내는 U+FDEF 문자 제외)의 복사본입니다.
ContentElement
  textBlock : TextBlock
[읽기 전용] 이 요소가 속하는 TextBlock입니다.
ContentElement
  textBlockBeginIndex : int
[읽기 전용] 이 요소의 첫 번째 문자의 텍스트 블록에 있는 인덱스입니다.
ContentElement
  textRotation : String
요소에 단위로 적용되는 회전입니다.
ContentElement
  userData : *
임의 데이터를 요소와 연관시키는 방법을 제작자에게 제공합니다.
ContentElement
Public 메서드
 메서드다음에 의해 정의됨
  
ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
new ContentElement() 생성자를 호출하면 ArgumentError 예외가 발생합니다.
ContentElement
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
Public 상수
 상수다음에 의해 정의됨
  GRAPHIC_ELEMENT : uint = 0xFDEF
[정적] 텍스트에 그래픽 요소가 있음을 나타냅니다.
ContentElement
속성 정보
elementFormat속성
elementFormat:ElementFormat  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

요소에 사용되는 ElementFormat 객체입니다.

기본값은 null입니다.

elementFormat 속성을 설정하는 경우 제공된 ElementFormat 객체가 잠깁니다. 즉, locked 속성이 true로 설정됩니다. 잠긴 ElementFormat은 수정할 수 없습니다.



구현
    public function get elementFormat():ElementFormat
    public function set elementFormat(value:ElementFormat):void

참고 사항

eventMirror속성 
eventMirror:EventDispatcher  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

이 내용 요소에 기반을 둔 유효한 텍스트 행에 전달된 모든 이벤트의 복사본을 수신하는 EventDispatcher 객체입니다. 런타임에는 특정 내용 요소에서 발생한 행의 부분을 확인하기가 어려울 수 있으므로 지정된 객체를 사용하여 텍스트 링크 또는 다른 대화형 텍스트에 대한 리스너를 설정할 수 있습니다. 텍스트를 배치하기 전에는 메트릭을 확인할 수 없는 밑줄 등의 장식을 적용하는 데 리스너를 사용할 수도 있습니다. 기본값은 미러링된 이벤트를 전달하지 않도록 하는 null입니다.

이벤트 미러는 텍스트 행에서 TextLineMirrorRegion 클래스의 인스턴스로 표시됩니다. 양방향 처리와 줄바꿈에 따라 미러 영역이 한 개 이상 생성될 수 있습니다.

기본값은 null입니다.



구현
    public function get eventMirror():EventDispatcher
    public function set eventMirror(value:EventDispatcher):void

참고 사항

groupElement속성 
groupElement:GroupElement  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

이 요소를 포함하는 GroupElement입니다. 이 요소가 그룹에 포함되지 않은 경우에는 null입니다.

기본값은 null입니다.



구현
    public function get groupElement():GroupElement

참고 사항

rawText속성 
rawText:String  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

요소에 있는 텍스트(U+FDEF 문자 포함)의 복사본입니다. U+FDEF 문자는 String의 그래픽 요소를 나타내는 임의 문자입니다.



구현
    public function get rawText():String
text속성 
text:String  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

요소에 있는 텍스트(String의 그래픽 요소를 나타내는 U+FDEF 문자 제외)의 복사본입니다.



구현
    public function get text():String

참고 사항

textBlock속성 
textBlock:TextBlock  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

이 요소가 속하는 TextBlock입니다.

기본값은 null입니다.



구현
    public function get textBlock():TextBlock

참고 사항

textBlockBeginIndex속성 
textBlockBeginIndex:int  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

이 요소의 첫 번째 문자의 텍스트 블록에 있는 인덱스입니다. 이 값은 캐시되지 않으며 이 메서드가 호출될 때마다 계산됩니다.

기본값은 -1입니다.



구현
    public function get textBlockBeginIndex():int
textRotation속성 
textRotation:String  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

요소에 단위로 적용되는 회전입니다. 이 속성에는 TextRotation 상수를 사용합니다.

기본값은 TextRotation.ROTATE_0입니다.

모든 글리프의 최종 회전은 ElementFormat.textRotation, ContentElement.textRotation 및 TextBlock.lineRotation의 합으로 결정됩니다.

ContentElement.textRotation은 텍스트를 포함하는 행과 다른 방식으로 회전하는 짧은 텍스트 흐름을 만드는 데 사용됩니다. 일본어 텍스트의 TCY 실행을 예로 들 수 있습니다. TCY는 Tate-Chu-Yoko의 약어이며 세로 방향 일본어 텍스트에 포함된 가로 방향 텍스트 흐름(일반적으로 숫자)을 나타냅니다. TCY 흐름이 들어 있는 세로 방향 일본어 텍스트 단락을 만들려면 다음을 수행합니다.

  1. TextBlock.lineRotation=TextRotation.ROTATE_90을 설정합니다.
  2. TextBlock.content를 세 개의 TextElement 객체로 구성되는 GroupElement로 설정합니다. 이들 중 첫 번째 요소는 TCY 실행 전의 일본어 텍스트이고, 두 번째 요소는 TCY 실행의 라틴어 텍스트이며, 세 번째 요소는 TCY 실행 후의 일본어 텍스트입니다.
  3. TCY TextElementtextRotation 속성을 TextRotation.ROTATE_270으로 설정합니다. TCY 텍스트 요소가 단위로 회전합니다. 행에서 상속된 90도 회전으로 시작합니다. 또 다른 270도를 추가하면 회전하여 수평이 됩니다.

회전한 내용 요소는 중첩할 수 없습니다. 복잡도에 상관없이 내용 요소의 모든 계층에서 textRotation 속성 세트를 설정할 수 있는 내용 요소는 한 개로 제한됩니다. 다음 메서드와 속성 setter를 사용하면 중첩된 회전이 감지된 경우 인수 오류가 발생합니다.

  1. ContentElement.textRotation
  2. GroupElement.setElements
  3. GroupElement.replaceElements

이 속성의 값을 설정하려면 다음 문자열 값을 사용합니다.

문자열 값설명
TextRotation.ROTATE_0 요소가 회전하지 않습니다.
TextRotation.ROTATE_90 요소가 시계 방향으로 90도 회전합니다.
TextRotation.ROTATE_180 요소가 180도 회전합니다.
TextRotation.ROTATE_270 요소가 시계 방향으로 270도 회전합니다.
TextRotation.AUTO 지원되지 않음.



구현
    public function get textRotation():String
    public function set textRotation(value:String):void

오류
ArgumentError TextRotation의 멤버가 아닌 값으로 설정된 경우입니다.
 
ArgumentError TextRotation.AUTO로 설정된 경우입니다.
 
ArgumentError — 작업으로 인해 GroupElement 내에 회전이 중첩되어 발생할 경우입니다.

참고 사항

userData속성 
public var userData:*

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

임의 데이터를 요소와 연관시키는 방법을 제작자에게 제공합니다.

기본값은 null입니다.

생성자 정보
ContentElement()생성자
public function ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

new ContentElement() 생성자를 호출하면 ArgumentError 예외가 발생합니다. 그러나 ContentElement의 다음과 같은 하위 클래스에 대해서는 생성자를 호출할 수 있습니다.

매개 변수
elementFormat:ElementFormat (default = null) — 요소의 텍스트에 대한 요소 형식입니다. 기본값은 null입니다.
 
eventMirror:EventDispatcher (default = null) — 이 내용 요소를 기반으로 만들어진 유효한 텍스트 행에 전달된 모든 이벤트의 복사본을 수신하는 EventDispatcher 객체입니다. 기본값은 null입니다.
 
textRotation:String (default = "rotate0") — 단위로 요소에 적용되는 회전입니다. 이 속성에는 TextRotation 상수를 사용합니다. 기본값은 TextRotation.ROTATE_0입니다.
상수 정보
GRAPHIC_ELEMENT상수
public static const GRAPHIC_ELEMENT:uint = 0xFDEF

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10, AIR 1.5

텍스트에 그래픽 요소가 있음을 나타냅니다.

참고 사항