패키지flash.text.engine
클래스public final class ElementFormat
상속ElementFormat Inheritance Object

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

ElementFormat 클래스는 ContentElement에 적용할 수 있는 형식 정보를 나타냅니다. ElementFormat 클래스를 사용하여 ContentElement의 여러 가지 하위 클래스에 대한 특정 텍스트 형식을 만들 수 있습니다. ElementFormat 클래스의 속성은 장치 글꼴과 포함된 글꼴에 모두 적용됩니다.

ElementFormat 객체를 TextBlock의 ContentElement에 적용하면 TextBlock이 무효화되지 않습니다. ElementFormat을 ContentElement에 적용하면 locked 속성이 true로 설정됩니다. 잠긴 ElementFormat 객체의 속성은 변경할 수 없습니다. 대신 clone() 메서드를 사용하여 객체의 잠기지 않은 복사본을 만들면 수정하거나 ContentElement에 할당할 수 있습니다.

예제 보기

참고 사항

flash.text.engine.ContentElement.elementFormat
Formatting text


Public 속성
 속성다음에 의해 정의됨
  alignmentBaseline : String
dominantBaseline이 물리는 요소를 포함하는 행의 기준선을 지정합니다. 이를 통해 행에 있는 요소의 세로 위치가 결정됩니다.
ElementFormat
  alpha : Number
요소 형식에 기초하여 모든 행 아톰의 alpha 속성을 지정된 숫자로 자동으로 설정하는 방법을 제작자에게 제공합니다.
ElementFormat
  baselineShift : Number
요소의 기준선 이동(픽셀 단위)을 나타냅니다.
ElementFormat
  breakOpportunity : String
이 텍스트에 적용되는 줄바꿈 기회입니다.
ElementFormat
  color : uint
텍스트의 색상을 나타냅니다.
ElementFormat
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  digitCase : String
이 텍스트에 사용되는 숫자 대/소문자입니다.
ElementFormat
  digitWidth : String
이 텍스트에 사용되는 숫자 폭입니다.
ElementFormat
  dominantBaseline : String
alignmentBaseline에 물리는 요소의 기준선을 지정합니다. 이를 통해 행에 있는 요소의 세로 위치가 결정됩니다.
ElementFormat
  fontDescription : FontDescription
글꼴을 설명하는 데 필요한 속성을 캡슐화하는 객체입니다.
ElementFormat
  fontSize : Number
텍스트의 크기(픽셀 단위)입니다.
ElementFormat
  kerning : String
이 텍스트에 사용되는 자간입니다.
ElementFormat
  ligatureLevel : String
이 텍스트에 사용되는 합자 수준입니다.
ElementFormat
  locale : String
텍스트의 로캘입니다.
ElementFormat
  locked : Boolean
ElementFormat의 잠김 여부를 나타냅니다.
ElementFormat
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  textRotation : String
개별 글리프에 적용되는 회전을 설정합니다.
ElementFormat
  trackingLeft : Number
각 글리프의 왼쪽에 적용된 추적 또는 수동 자간(픽셀 단위)입니다.
ElementFormat
  trackingRight : Number
각 글리프의 오른쪽에 적용된 추적 또는 수동 자간(픽셀 단위)입니다.
ElementFormat
  typographicCase : String
이 텍스트에 사용되는 입력 체계 대/소문자입니다.
ElementFormat
Public 메서드
 메서드다음에 의해 정의됨
  
ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")
ElementFormat 객체를 만듭니다.
ElementFormat
  
ElementFormat의 잠기지 않은 복사본을 만듭니다.
ElementFormat
  
fontDescription 및 fontSize로 지정한 글꼴의 전각 상자, 취소선 위치, 취소선 굵기, 밑줄 위치 및 밑줄 굵기를 설명하는 속성이 포함된 FontMetrics 객체를 반환합니다.
ElementFormat
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
속성 정보
alignmentBaseline속성
alignmentBaseline:String  [읽기/쓰기]

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

dominantBaseline이 물리는 요소를 포함하는 행의 기준선을 지정합니다. 이를 통해 행에 있는 요소의 세로 위치가 결정됩니다. 이 속성에는 flash.text.engine.TextBaseline 상수를 사용합니다.

행에서 가장 큰 요소가 기준선을 결정하지만 TextBlock.baselineFontDescriptionTextBlock.baselineFontSize를 설정하여 이러한 논리를 재정의할 수 있습니다.

기본값은 flash.text.engine.TextBaseline.USE_DOMINANT_BASELINE입니다.

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

문자열 값설명
TextBaseline.ROMAN dominantBaseline이 행의 로마자 기준선에 맞춰 정렬됩니다.
TextBaseline.ASCENT dominantBaseline이 행의 어센트 기준선에 맞춰 정렬됩니다.
TextBaseline.DESCENT dominantBaseline이 행의 디센트 기준선에 맞춰 정렬됩니다.
TextBaseline.IDEOGRAPHIC_TOP dominantBaseline이 행의 표의 문자 맨 위 기준선에 맞춰 정렬됩니다.
TextBaseline.IDEOGRAPHIC_CENTER dominantBaseline이 행의 표의 문자 중앙 기준선에 맞춰 정렬됩니다.
TextBaseline.IDEOGRAPHIC_BOTTOM dominantBaseline이 행의 표의 문자 맨 아래 기준선에 맞춰 정렬됩니다.
TextBaseline.USE_DOMINANT_BASELINE dominantBaseline이 행의 동일한 기준선에 맞춰 정렬됩니다.

하위 클래스속성 설정 효과
GraphicElement 그래픽 요소의 dominantBaseline을 정렬하는 기준이 되는 행의 정렬 기준선을 설정합니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 텍스트 요소의 dominantBaseline을 정렬하는 기준이 되는 행의 정렬 기준선을 설정합니다.



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

오류
ArgumentError flash.text.engine.TextBaseline의 멤버가 아닌 임의의 값으로 설정된 경우입니다.
 
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

alpha속성 
alpha:Number  [읽기/쓰기]

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

요소 형식에 기초하여 모든 행 아톰의 alpha 속성을 지정된 숫자로 자동으로 설정하는 방법을 제작자에게 제공합니다.

지정된 객체의 알파 투명도 값을 나타냅니다. 유효한 값은 0(완전 투명)에서 1(완전 불투명) 사이입니다. 기본값은 1입니다. alpha가 0으로 설정된 표시 객체는 눈에 보이지는 않지만 활성화되어 있습니다.

기본값은 1.0입니다.

하위 클래스속성 설정 효과
GraphicElement 지정된 알파 값을 그래픽 요소에 적용합니다. 그래픽 DisplayObject 자체나 TextLine에 설정된 모든 알파 값과 곱하여 결합합니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 지정된 알파 값을 텍스트 요소에 적용합니다. TextLine에 설정된 모든 알파 값과 곱하여 결합합니다.



구현
    public function get alpha():Number
    public function set alpha(value:Number):void

오류
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

baselineShift속성 
baselineShift:Number  [읽기/쓰기]

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

요소의 기준선 이동(픽셀 단위)을 나타냅니다.

여기에 지정한 크기만큼 요소가 dominantBaseline에서 멀리 이동합니다. 요소 멤버의 y 위치에 오프셋이 더해지므로 회전하지 않은 텍스트의 경우 기준선 이동 크기를 양수로 지정하면 요소가 아래로 이동하고 기준선 이동 크기를 음수로 지정하면 요소가 위로 이동합니다.

기본값은 이동 없음을 나타내는 0.0입니다.

하위 클래스속성 설정 효과
GraphicElement 그래픽을 기준선에서 멀리 이동합니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 텍스트를 기준선에서 멀리 이동합니다.



구현
    public function get baselineShift():Number
    public function set baselineShift(value:Number):void

오류
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

breakOpportunity속성 
breakOpportunity:String  [읽기/쓰기]

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

이 텍스트에 적용되는 줄바꿈 기회입니다. 이 속성은 줄바꿈 가능한 텍스트를 여러 행으로 분할할 때 줄바꿈에 사용할 수 있는 문자를 결정합니다. 이 속성에는 flash.text.engine.BreakOpportunity 상수를 사용합니다.

기본값은 flash.text.engine.BreakOpportunity.AUTO입니다.

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

문자열 값설명
BreakOpportunity.AUTO 줄바꿈 기회는 단어 사이의 구분이나 하이픈 같은 표준 유니코드 문자 속성을 기반으로 합니다.
BreakOpportunity.ANY ContentElement 객체의 모든 문자가 줄바꿈 기회로 취급됩니다. 이 값은 일반적으로 로마자 텍스트가 아시아권 언어의 텍스트에 포함되어 있고 단어 중간에서 줄바꿈하는 것이 바람직한 경우에 사용합니다.
BreakOpportunity.NONE 범위의 어떠한 문자도 줄바꿈 기회로 취급되지 않습니다.
BreakOpportunity.ALL 범위의 모든 문자가 줄바꿈 기회로 취급됩니다. 경로의 텍스트와 같은 효과를 만드는 데 유용합니다.

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 그룹의 인접한 텍스트 요소 사이에서 줄바꿈 기회를 결정합니다. 그룹의 elementFormat이 null인 경우 인접한 첫 번째 요소의 형식이 사용됩니다.
TextElement 텍스트 요소의 문자 사이에서 줄바꿈 기회를 결정합니다.



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

오류
ArgumentError flash.text.engine.BreakOpportunity의 멤버가 아닌 값으로 설정한 경우입니다.
 
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

color속성 
color:uint  [읽기/쓰기]

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

텍스트의 색상을 나타냅니다. 8비트 RGB 구성 요소 세 개를 포함하는 정수입니다. 예를 들어 0xFF0000은 빨강이고 0x00FF00은 녹색입니다.

기본값은 0x000000입니다. 이 경우 Flash Player에서 검정색이 사용됩니다.

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 텍스트의 색상을 설정합니다.



구현
    public function get color():uint
    public function set color(value:uint):void

오류
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.
digitCase속성 
digitCase:String  [읽기/쓰기]

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

이 텍스트에 사용되는 숫자 대/소문자입니다. 숫자 대/소문자는 숫자 문자 그룹의 스타일과 배치에 영향을 줍니다. 이 속성에는 flash.text.engine.DigitCase 상수를 사용합니다.

기본값은 flash.text.engine.DigitCase.DEFAULT입니다.

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

문자열 값설명
DigitCase.DEFAULT 기본 숫자 대/소문자를 텍스트에 적용합니다.
DigitCase.LINING 라이닝 숫자 대/소문자를 텍스트에 적용합니다.
DigitCase.OLD_STYLE 이전 스타일 숫자 대/소문자를 텍스트에 적용합니다.

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 요소의 텍스트에 사용되는 숫자 대/소문자를 결정합니다.



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

오류
ArgumentError flash.text.engine.DigitCase의 멤버가 아닌 임의의 값으로 설정된 경우입니다.
 
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

digitWidth속성 
digitWidth:String  [읽기/쓰기]

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

이 텍스트에 사용되는 숫자 폭입니다. 이 속성에는 flash.text.engine.DigitWidth 상수를 사용합니다.

기본값은 flash.text.engine.DigitWidth.DEFAULT입니다.

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

문자열 값설명
DigitWidth.DEFAULT 기본 숫자 폭을 텍스트에 적용합니다.
DigitWidth.PROPORTIONAL 비례 숫자 폭을 텍스트에 적용합니다.
DigitWidth.TABULAR 표 형식 숫자 폭을 텍스트에 적용합니다.

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 요소의 텍스트에 사용되는 숫자 폭을 결정합니다.



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

오류
ArgumentError flash.text.engine.DigitWidth의 멤버가 아닌 임의의 값으로 설정된 경우입니다.
 
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

dominantBaseline속성 
dominantBaseline:String  [읽기/쓰기]

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

alignmentBaseline에 물리는 요소의 기준선을 지정합니다. 이를 통해 행에 있는 요소의 세로 위치가 결정됩니다. 이 속성에는 flash.text.engine.TextBaseline 상수를 사용합니다.

요소의 내용이 기준선을 결정합니다. TextElement의 경우 글꼴과 포인트 크기가 기준선을 결정합니다. GraphicElement의 경우에는 요소의 높이가 기준선을 결정합니다.

기본값은 flash.text.engine.TextBaseline.ROMAN입니다.

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

문자열 값설명
TextBaseline.ROMAN 요소의 로마자 기준선이 alignmentBaseline에 맞춰 정렬됩니다.
TextBaseline.ASCENT 요소의 어센트 기준선이 alignmentBaseline에 맞춰 정렬됩니다.
TextBaseline.DESCENT 요소의 디센트 기준선이 alignmentBaseline에 맞춰 정렬됩니다.
TextBaseline.IDEOGRAPHIC_TOP 요소의 표의 문자 맨 위 기준선이 alignmentBaseline에 맞춰 정렬됩니다.
TextBaseline.IDEOGRAPHIC_CENTER 요소의 표의 문자 중앙 기준선이 alignmentBaseline에 맞춰 정렬됩니다.
TextBaseline.IDEOGRAPHIC_BOTTOM 요소의 표의 문자 맨 아래 기준선이 alignmentBaseline에 맞춰 정렬됩니다.

하위 클래스속성 설정 효과
GraphicElement alignmentBaseline에 맞춰 정렬할 그래픽 요소의 기준선을 결정합니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement alignmentBaseline에 맞춰 정렬할 텍스트 요소의 기준선을 결정합니다.



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

오류
ArgumentError flash.text.engine.TextBaseline의 멤버가 아닌 임의의 값으로 설정된 경우입니다.
 
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

fontDescription속성 
fontDescription:FontDescription  [읽기/쓰기]

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

글꼴을 설명하는 데 필요한 속성을 캡슐화하는 객체입니다.

기본값은 기본적으로 생성된 FontDescription 객체입니다.

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

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 요소의 텍스트에 사용되는 글꼴을 결정합니다.



구현
    public function get fontDescription():FontDescription
    public function set fontDescription(value:FontDescription):void

오류
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

fontSize속성 
fontSize:Number  [읽기/쓰기]

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

텍스트의 크기(픽셀 단위)입니다.

기본값은 12.0입니다.

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 요소의 텍스트에 사용되는 픽셀 크기를 결정합니다.



구현
    public function get fontSize():Number
    public function set fontSize(value:Number):void

오류
ArgumentError — 0보다 작은 값으로 설정된 경우입니다.
 
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.
kerning속성 
kerning:String  [읽기/쓰기]

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

이 텍스트에 사용되는 자간입니다. 이 속성에는 flash.text.engine.Kerning 상수를 사용합니다. 자간은 가독성을 향상시키기 위해 특정 문자 쌍 간의 픽셀을 조정합니다. 자간은 자간 표가 있는 모든 글꼴에 지원됩니다.

기본값은 flash.text.engine.Kerning.ON입니다.

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

문자열 값설명
Kerning.ON 자간을 활성화합니다.
Kerning.OFF 자간을 활성화하지 않습니다.
Kerning.AUTO 아시아권 언어의 문자에 대해서만 자간이 활성화됩니다. 자간은 간지, 히라가나 또는 가타카나가 아닌 두 문자 사이에 적용됩니다.

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 그룹의 인접한 텍스트 요소 사이에 자간을 적용할지 여부를 결정합니다. 그룹의 elementFormat이 null인 경우 인접한 첫 번째 요소의 형식이 사용됩니다.
TextElement 텍스트 요소의 문자 사이에 자간을 적용할지 여부를 결정합니다.



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

오류
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

ligatureLevel속성 
ligatureLevel:String  [읽기/쓰기]

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

이 텍스트에 사용되는 합자 수준입니다. 합자는 둘 이상의 글자 모양을 결합하여 단일 글리프를 만드는 것입니다. 합자는 일반적으로 공통 구성 요소를 공유하는 연속된 문자(예: 'fi', 'fl' 또는 'ae' 글자 쌍)를 대체합니다. 합자는 라틴어 및 라틴어가 아닌 문자 세트에 모두 사용됩니다. 이 속성에는 flash.text.engine.LigatureLevel 상수를 사용합니다.

기본값은 flash.text.engine.LigatureLevel.COMMON입니다.

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

문자열 값설명
LigatureLevel.NONE 합자를 만들지 않습니다.
LigatureLevel.MINIMUM 최소 합자를 만듭니다.
LigatureLevel.COMMON 일반 합자를 만듭니다.
LigatureLevel.UNCOMMON 특수 합자를 만듭니다.
LigatureLevel.EXOTIC 이국적 합자를 만듭니다.

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 그룹의 인접한 텍스트 요소 사이에 합자 수준을 결정합니다. 그룹의 elementFormat이 null인 경우 인접한 첫 번째 요소의 형식이 사용됩니다.
TextElement 텍스트 요소의 문자 사이에 합자 수준을 결정합니다.



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

오류
ArgumentError flash.text.engine.LigatureLevel의 멤버가 아닌 임의의 값으로 설정된 경우입니다.
 
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

locale속성 
locale:String  [읽기/쓰기]

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

텍스트의 로캘입니다. 대/소문자 변형 및 모양을 제어합니다. 표준 로캘 식별자가 사용됩니다. 예를 들어 "en", "en_US" 및 "en-US"는 모두 영어를 나타내고 "ja"는 일본어를 나타냅니다.

기본값은 "en"입니다.

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 요소의 텍스트에 대한 변형과 모양을 결정합니다.



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

오류
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.
locked속성 
locked:Boolean  [읽기/쓰기]

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

ElementFormat의 잠김 여부를 나타냅니다. true이면 ElementFormat을 수정할 수 없습니다. ElementFormat 객체의 잠기지 않은 복사본을 가져오려면 ElementFormat.clone()을 호출합니다.



구현
    public function get locked():Boolean
    public function set locked(value:Boolean):void

오류
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

textRotation속성 
textRotation:String  [읽기/쓰기]

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

개별 글리프에 적용되는 회전을 설정합니다. 이 속성에는 flash.text.engine.TextRotation 상수를 사용합니다.

기본값은 flash.text.engine.TextRotation.AUTO입니다.

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

ElementFormat.textRotation은 아시아권 언어의 텍스트에서 flash.text.engine.TextRotation.AUTO 값과 TextBlock.lineRotation = flash.text.engine.ROTATE_90을 함께 사용하여 문자를 세로 레이아웃으로 올바르게 표시하기 위해 문자를 회전해야 하는 일반적인 경우에 사용됩니다.

세로 레이아웃 정보가 포함되지 않은 글꼴에 대해 이 속성을 설정하면 엉뚱한 결과가 발생할 수 있습니다. 일본어 글꼴 "MS Mincho" 같이 vmtx 또는 VORG 표를 포함하는 글꼴의 경우 레이아웃 엔진에서 레이아웃을 올바르게 처리하는 데 필요한 데이터가 이러한 표를 통해 제공되므로 특별한 문제가 발생하지 않습니다. 필요한 정보가 들어 있지 않은 Verdana와 같은 글꼴은 제대로 처리되지 않을 수 있습니다.

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

문자열 값설명
TextRotation.ROTATE_0 글리프가 회전하지 않습니다.
TextRotation.ROTATE_90 글리프가 시계 방향으로 90도 회전합니다.
TextRotation.ROTATE_180 글리프가 180도 회전합니다.
TextRotation.ROTATE_270 글리프가 시계 방향으로 270도 회전합니다.
TextRotation.AUTO 전자 및 넓은 글리프에만 글리프의 유니코드 속성에 따라 반시계 방향 90도 회전을 지정합니다. 이 값은 일반적으로 아시아권 언어의 텍스트에서 회전이 필요한 글리프만 회전하는 데 사용됩니다. 이 회전은 수직 텍스트에만 적용되어 다른 문자에는 영향을 주지 않고 전자 및 넓은 문자를 세로 방향으로 되돌립니다.

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 텍스트 요소에 포함된 글리프의 회전을 결정합니다.



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

오류
ArgumentError flash.text.engine.TextRotation의 멤버가 아닌 임의의 값으로 설정된 경우입니다.
 
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

trackingLeft속성 
trackingLeft:Number  [읽기/쓰기]

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

각 글리프의 왼쪽에 적용된 추적 또는 수동 자간(픽셀 단위)입니다. kerning이 활성화된 경우 trackingLeft 값이 글꼴에 대한 자간 표의 값에 추가됩니다. kerning이 활성화되지 않은 경우 trackingLeft 값이 수동 자간 값으로 사용됩니다. 양수 및 음수 값을 모두 지원합니다.

일반적으로 적절한 추적 값은 trackingRighttrackingLeft 사이에 있습니다. 그렇지 않으면 방향성이 혼합된 텍스트에서 한 쪽 양방향 경계에는 추적이 두 배로 적용되고 다른 쪽에는 전혀 적용되지 않습니다.

기본값은 0.0입니다.

하위 클래스속성 설정 효과
GraphicElement 그래픽의 왼쪽에 적용되는 추적을 결정합니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 텍스트 요소에서 문자의 왼쪽에 적용되는 추적을 결정합니다.

예제:

//positive tracking added to kerning
       var ef1:ElementFormat = new ElementFormat();
       ef1.kerning = flash.text.engine.Kerning.ON;
       ef1.trackingLeft = 0.5;
         //negative manual kerning
       var ef2:ElementFormat = new ElementFormat();
       ef2.kerning = flash.text.engine.Kerning.OFF;
       ef2.trackingLeft = -1.0;



구현
    public function get trackingLeft():Number
    public function set trackingLeft(value:Number):void

오류
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

trackingRight속성 
trackingRight:Number  [읽기/쓰기]

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

각 글리프의 오른쪽에 적용된 추적 또는 수동 자간(픽셀 단위)입니다. kerning이 활성화된 경우 trackingRight 값이 글꼴에 대한 자간 표의 값에 추가됩니다. kerning이 활성화되지 않은 경우 trackingRight 값이 수동 자간 값으로 사용됩니다. 양수 및 음수 값을 모두 지원합니다.

일반적으로 적절한 추적 값은 trackingRighttrackingLeft 사이에 있습니다. 그렇지 않으면 방향성이 혼합된 텍스트에서 한 쪽 양방향 경계에는 추적이 두 배로 적용되고 다른 쪽에는 전혀 적용되지 않습니다.

기본값은 0.0입니다.

하위 클래스속성 설정 효과
GraphicElement 그래픽의 오른쪽에 적용되는 추적을 결정합니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 텍스트 요소에서 문자의 오른쪽에 적용되는 추적을 결정합니다.

예제:

//positive tracking added to kerning
       var ef1:ElementFormat = new ElementFormat();
       ef1.kerning = flash.text.engine.Kerning.ON;
       ef1.trackingRight = 0.5;
         //negative manual kerning
       var ef2:ElementFormat = new ElementFormat();
       ef2.kerning = flash.text.engine.Kerning.OFF;
       ef2.trackingRight = -1.0;



구현
    public function get trackingRight():Number
    public function set trackingRight(value:Number):void

오류
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

typographicCase속성 
typographicCase:String  [읽기/쓰기]

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

이 텍스트에 사용되는 입력 체계 대/소문자입니다. 이 속성에는 flash.text.engine.TypographicCase 상수를 사용합니다.

기본값은 flash.text.engine.TypographicCase.DEFAULT입니다.

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

문자열 값설명
TypographicCase.DEFAULT 기본 입력 체계 대/소문자를 텍스트에 적용합니다.
TypographicCase.TITLE 출력 시 대문자에 제목 글리프를 사용하도록 지정합니다.
TypographicCase.CAPS 출력 시 대문자에 대해 간격을 조정하도록 지정합니다.
TypographicCase.SMALL_CAPS 출력 시 대문자에 작은 대문자 글리프를 사용하도록 지정합니다.
TypographicCase.UPPERCASE 출력 시 모든 문자에 대문자 글리프를 사용하도록 지정합니다.
TypographicCase.LOWERCASE 출력 시 모든 문자에 소문자 글리프를 사용하도록 지정합니다.
TypographicCase.CAPS_AND_SMALL_CAPS 출력 시 모든 소문자에 작은 대문자 글리프를 사용하도록 지정합니다.

하위 클래스속성 설정 효과
GraphicElement 어떠한 영향도 미치지 않습니다.
GroupElement 어떠한 영향도 미치지 않습니다.
TextElement 요소의 텍스트에 사용되는 입력 체계 대/소문자를 결정합니다.



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

오류
ArgumentError flash.text.engine.TypographicCase의 멤버가 아닌 값으로 설정된 경우입니다.
 
IllegalOperationError — ElementFormat 객체를 잠근(lockedtrue) 상태에서 설정된 경우입니다.

참고 사항

생성자 정보
ElementFormat()생성자
public function ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")

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

ElementFormat 객체를 만듭니다.

매개 변수
fontDescription:FontDescription (default = null) — 이 요소 형식에 사용할 글꼴을 식별하는 FontDescription 객체입니다. 기본값은 null입니다. 글꼴 설명을 제공하지 않으면 기본 글꼴 설명이 만들어집니다.
 
fontSize:Number (default = 12.0) — 텍스트의 크기(픽셀 단위)입니다.
 
color:uint (default = 0x000000) — 텍스트의 색상입니다. 세 개의 8비트 RGB 구성 요소를 포함하는 숫자입니다. 예를 들어, 0xFF0000은 빨강이고 0x00FF00은 녹색입니다.
 
alpha:Number (default = 1.0) — 요소 형식을 기반으로 모든 행 아톰에 적용할 alpha 속성입니다.
 
textRotation:String (default = "auto") — 개별 글리프에 적용되는 회전입니다. 이 속성에는 flash.text.engine.TextRotation 상수를 사용합니다.
 
dominantBaseline:String (default = "roman") — 텍스트의 글리프가 물리는 기준선입니다. 이 속성에는 flash.text.engine.TextBaseline 상수를 사용합니다.
 
alignmentBaseline:String (default = "useDominantBaseline") — 주 기준선이 물리는 포함 행의 기준선입니다. 이 속성에는 flash.text.engine.TextBaseline 상수를 사용합니다.
 
baselineShift:Number (default = 0.0) — 텍스트의 기준선 이동(전각 픽셀 단위)입니다.
 
kerning:String (default = "on") — 이 텍스트에 사용되는 자간입니다. flash.text.engine.Kerning을 사용합니다.
 
trackingRight:Number (default = 0.0) — 각 글리프의 오른쪽에 적용된 추적 또는 수동 자간(픽셀 단위)입니다.
 
trackingLeft:Number (default = 0.0) — 각 글리프의 왼쪽에 적용된 추적 또는 수동 자간(픽셀 단위)입니다.
 
locale:String (default = "en") — 텍스트의 로캘입니다.
 
breakOpportunity:String (default = "auto") — 이 텍스트에 적용되는 줄바꿈 기회입니다. 이 속성에는 flash.text.engine.BreakOpportunity 상수를 사용합니다.
 
digitCase:String (default = "default") — 이 텍스트에 사용되는 숫자 대/소문자입니다. 이 속성에는 flash.text.engine.DigitCase 상수를 사용합니다.
 
digitWidth:String (default = "default") — 이 텍스트에 사용되는 숫자 폭입니다. 이 속성에는 flash.text.engine.DigitWidth 상수를 사용합니다.
 
ligatureLevel:String (default = "common") — 이 텍스트에 사용되는 합자 수준입니다. 이 속성에는 flash.text.engine.LigatureLevel 상수를 사용합니다.
 
typographicCase:String (default = "default") — 이 텍스트에 사용되는 입력 체계 대/소문자입니다. 이 속성에는 flash.text.engine.TypographicCase 상수를 사용합니다.

오류
ArgumentError — 지정된 fontSize가 0보다 작습니다.
 
ArgumentError — 지정된 textRotationflash.text.engine.TextRotation의 멤버가 아닙니다.
 
ArgumentError — 지정된 dominantBaselineflash.text.engine.TextBaseline의 멤버가 아닙니다.
 
ArgumentError — 지정된 alignmentBaselineflash.text.engine.TextBaseline의 멤버가 아닙니다.
 
ArgumentError — 지정된 kerningflash.text.engine.Kerning의 멤버가 아닙니다.
 
ArgumentError — 지정된 breakOpportunityflash.text.engine.BreakOpportunity의 멤버가 아닙니다.
 
ArgumentError — 지정된 digitCaseflash.text.engine.DigitCase의 멤버가 아닙니다.
 
ArgumentError — 지정된 digitWidthflash.text.engine.DigitWidth의 멤버가 아닙니다.
 
ArgumentError — 지정된 ligatureLevelflash.text.engine.LigatureLevel의 멤버가 아닙니다.
 
ArgumentError — 지정된 typographicCaseflash.text.engine.TypographicCase의 멤버가 아닙니다.
메서드 정보
clone()메서드
public function clone():ElementFormat

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

ElementFormat의 잠기지 않은 복사본을 만듭니다.

반환값
ElementFormatElementFormat 객체의 잠기지 않은 복사본입니다.

참고 사항


예제

다음 예제에서는 ElementFormat 객체를 만들고 FontSize를 설정합니다. 새 TextElement를 만들고 이때 ElementFormat을 사용하여 잠급니다. TextElementTextBlock의 내용으로 사용됩니다. TextBlock에서 텍스트 행을 만듭니다.

ElementFormat 객체를 수정하려면 먼저 locked 속성을 선택합니다. true이면 clone() 메서드를 사용하여 ElementFormat의 잠기지 않은 복사본을 만들고 속성을 변경한 후 새 ElementFormatTextBlock에 다시 연결합니다. 행을 다시 줄바꿈할 때 새 행에 새 글꼴 설정이 적용됩니다.

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class ElementFormat_cloneExample extends Sprite {
        private var ef1:ElementFormat;
        private var ef2:ElementFormat;
        
        public function ElementFormat_cloneExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
            fd.fontName = "Palatino";

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize=20;
            
            var str:String = "This is flash text 0123456789";
            var tb:TextBlock = new TextBlock();
            var te1:TextElement = new TextElement(str, ef1);
            tb.content = te1;
            var line1:TextLine = tb.createTextLine(null, 600);
            addChild(line1);
            
            ef2 = (ef1.locked) ? ef1.clone() : ef1;    
            ef2.fontSize = 32;

            tb.content.elementFormat=ef2;
            var line2:TextLine = tb.createTextLine(null, 600);
            addChild(line2);
            
        }
    }    
}
getFontMetrics()메서드 
public function getFontMetrics():FontMetrics

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

fontDescriptionfontSize로 지정한 글꼴의 전각 상자, 취소선 위치, 취소선 굵기, 밑줄 위치 및 밑줄 굵기를 설명하는 속성이 포함된 FontMetrics 객체를 반환합니다.

반환값
FontMetricsfontDescription으로 지정한 글꼴의 속성을 설명하는 FontMetrics 객체입니다.

참고 사항


예제

다음은 지정된 FontDescription을 사용하여 ElementFormat 객체를 만들고 getFontMetrics 메서드를 사용하여 선택된 글꼴의 메트릭을 표시하는 예제입니다.
package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class FontMetricsExample extends Sprite {
        
        public function FontMetricsExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontName = "Garamond";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;

            var ef1:ElementFormat = new ElementFormat(fd);
            var fm1:FontMetrics = ef1.getFontMetrics();
            trace(fm1.emBox);
            trace(fm1.strikethroughOffset);
            trace(fm1.strikethroughThickness);
            trace(fm1.subscriptScale);
            trace(fm1.subscriptOffset);
            trace(fm1.superscriptScale);
            trace(fm1.superscriptOffset);
            trace(fm1.underlineOffset);
            trace(fm1.underlineThickness);
            
            
        }
    }    
}
예제 예제 사용 방법
ElementFormatExample.as

다음 예제에서는 먼저 두 개의 ElementFormat 객체를 만들고 여러 가지 속성을 설정합니다. 그런 다음 TextBlock의 content로 지정된 TextElement 객체에 새 ElementFormat을 할당합니다. TextElementElementFormat을 변경해도 이전에 부모 TextBlock을 통해 만들었던 TextLine은 영향을 받지 않습니다.

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class ElementFormatExample extends Sprite {
        
        public function ElementFormatExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontName = "Garamond";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize = 30;
            ef1.color = 0xFF0000;
            ef1.alpha = 100;
            ef1.kerning = flash.text.engine.Kerning.ON;
            ef1.trackingRight = 2;
            ef1.typographicCase = flash.text.engine.TypographicCase.UPPERCASE;
            ef1.alignmentBaseline = flash.text.engine.TextBaseline.DESCENT;
            ef1.ligatureLevel = flash.text.engine.LigatureLevel.EXOTIC;
            
            var ef2:ElementFormat = new ElementFormat(fd);
            ef2.fontSize = 30;
            ef2.color = 0xFF0000;
            ef2.alpha = 0.3;
            ef2.kerning = flash.text.engine.Kerning.OFF;
            ef2.typographicCase = flash.text.engine.TypographicCase.LOWERCASE;
            ef2.digitCase = flash.text.engine.DigitCase.OLD_STYLE;
            ef2.textRotation = flash.text.engine.TextRotation.ROTATE_180;
            
            var str:String = "This is flash text 0123456789";
            var tb:TextBlock = new TextBlock();
            var te1:TextElement = new TextElement(str, ef1);
            tb.content = te1;
            var line1:TextLine = tb.createTextLine(null, 600);
            addChild(line1);
            line1.x = 15;
            line1.y = 30;

            tb.content.elementFormat = ef2;
            var line2:TextLine = tb.createTextLine(null, 600);
            addChild(line2);
            line2.x = 15;
            line2.y = 60;
            
        }
    }    
}