| 패키지 | flash.text.engine |
| 클래스 | public final class ElementFormat |
| 상속 | ElementFormat  Object |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
TextBlock의 ContentElement에 적용된 ElementFormat 객체는 TextBlock을 무효화하지 않습니다. ElementFormat을 ContentElement에 적용하면 locked 속성이 true로 설정됩니다. 잠긴 ElementFormat 객체의 속성은 변경할 수 없습니다. 대신 clone() 메서드를 사용하여 객체의 잠기지 않은 복사본을 만들면 수정하거나 ContentElement에 할당할 수 있습니다.
관련 API 요소
공용 속성
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
| alignmentBaseline : String
포함하는 요소의 기준선 유형을 이 형식의 요소에 대한 주 기준선에 정렬하도록 지정합니다. | ElementFormat | ||
| alpha : Number
이 객체의 영향을 받는 줄 요소의 투명도를 지정합니다. | ElementFormat | ||
| baselineShift : Number
요소의 기준선 이동(픽셀 단위)을 나타냅니다. | ElementFormat | ||
| breakOpportunity : String
이 텍스트에 적용되는 줄바꿈 기회입니다. | ElementFormat | ||
| color : uint
텍스트의 색상을 나타냅니다. | ElementFormat | ||
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| digitCase : String
이 텍스트에 사용되는 숫자 대/소문자입니다. | ElementFormat | ||
| digitWidth : String
이 텍스트에 사용되는 숫자 폭입니다. | ElementFormat | ||
| dominantBaseline : String
주 기준선으로 사용할 기준선 유형을 지정합니다. | ElementFormat | ||
| fontDescription : FontDescription
속성에서 글꼴을 설명하는 객체입니다. | ElementFormat | ||
| fontSize : Number
텍스트의 크기(픽셀 단위)입니다. | ElementFormat | ||
| kerning : String
커닝은 가독성을 향상시키기 위해 특정 문자 쌍 간의 픽셀을 조정합니다. | ElementFormat | ||
| ligatureLevel : String
이 텍스트에 사용되는 합자 수준입니다. | ElementFormat | ||
| locale : String
텍스트의 로캘입니다. | ElementFormat | ||
| locked : Boolean
ElementFormat의 잠김 여부를 나타냅니다. | ElementFormat | ||
| textRotation : String
개별 글리프에 적용되는 회전을 설정합니다. | ElementFormat | ||
| trackingLeft : Number
각 글리프의 왼쪽에 적용된 추적 또는 수동 커닝(픽셀 단위)입니다. | ElementFormat | ||
| trackingRight : Number
각 글리프의 오른쪽에 적용된 추적 또는 수동 커닝(픽셀 단위)입니다. | ElementFormat | ||
| typographicCase : String
이 텍스트에 사용되는 입력 체계 대/소문자입니다. | ElementFormat | ||
공용 메서드
| 메서드 | 정의 주체 | ||
|---|---|---|---|
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 | ||
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
속성 세부 정보
alignmentBaseline | 속성 |
alignmentBaseline:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
포함하는 요소의 기준선 유형을 이 형식의 요소에 대한 주 기준선에 정렬하도록 지정합니다. 이 속성에는 TextBaseline 상수를 사용합니다.
줄에서 가장 큰 가로 요소가 기준선의 정렬을 결정하지만 TextBlock.baselineFontDescription 및 TextBlock.baselineFontSize를 설정하여 이러한 논리를 재정의할 수 있습니다.
기본값은 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 — TextBaseline의 멤버가 아닌 값으로 설정된 경우입니다.
| |
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
alpha | 속성 |
alpha:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
이 객체의 영향을 받는 줄 요소의 투명도를 지정합니다. 올바른 값은 0(완전 투명)부터 1(완전 불투명)까지입니다. alpha가 0으로 설정된 표시 객체는 눈에 보이지는 않지만 활성화되어 있습니다.
기본값은 1입니다.
| 하위 클래스 | 속성 설정 효과 |
|---|---|
GraphicElement | 지정된 알파 값을 그래픽 요소에 적용합니다. 그래픽 DisplayObject 자체나 TextLine에 설정된 모든 알파 값과 곱하여 결합합니다. |
GroupElement | 어떠한 영향도 미치지 않습니다. |
TextElement | 지정된 알파 값을 텍스트 요소에 적용합니다. TextLine에 설정된 모든 알파 값과 곱하여 결합합니다. |
구현
public function get alpha():Number public function set alpha(value:Number):void오류
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
baselineShift | 속성 |
baselineShift:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
요소의 기준선 이동(픽셀 단위)을 나타냅니다.
여기에 지정한 크기만큼 요소가 dominantBaseline에서 멀리 이동합니다. 요소 멤버의 y 위치에 오프셋이 더해지므로 회전하지 않은 텍스트의 경우 기준선 이동 크기를 양수로 지정하면 요소가 아래로 이동하고 기준선 이동 크기를 음수로 지정하면 요소가 위로 이동합니다.
기본값은 이동 없음을 나타내는 0.0입니다.
| 하위 클래스 | 속성 설정 효과 |
|---|---|
GraphicElement | 그래픽을 기준선에서 멀리 이동합니다. |
GroupElement | 어떠한 영향도 미치지 않습니다. |
TextElement | 텍스트를 기준선에서 멀리 이동합니다. |
구현
public function get baselineShift():Number public function set baselineShift(value:Number):void오류
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
breakOpportunity | 속성 |
breakOpportunity:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
이 텍스트에 적용되는 줄바꿈 기회입니다. 이 속성은 줄바꿈 가능한 텍스트를 여러 행으로 분할할 때 줄바꿈에 사용할 수 있는 문자를 결정합니다. 이 속성에는 BreakOpportunity 상수를 사용합니다.
기본값은 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 — BreakOpportunity의 멤버가 아닌 값으로 설정된 경우입니다.
| |
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
color | 속성 |
color:uint| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
텍스트의 색상을 나타냅니다. 8비트 RGB 구성 요소 세 개를 포함하는 정수입니다. 예를 들어 0xFF0000은 빨강이고 0x00FF00은 녹색입니다.
기본값은 0x000000인 검정입니다.
| 하위 클래스 | 속성 설정 효과 |
|---|---|
GraphicElement | 어떠한 영향도 미치지 않습니다. |
GroupElement | 어떠한 영향도 미치지 않습니다. |
TextElement | 텍스트의 색상을 설정합니다. |
구현
public function get color():uint public function set color(value:uint):void오류
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
digitCase | 속성 |
digitCase:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
이 텍스트에 사용되는 숫자 대/소문자입니다. 숫자 대/소문자는 숫자 문자 그룹의 스타일과 배치에 영향을 줍니다. 이 속성에는 DigitCase 상수를 사용합니다.
기본값은 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 — DigitCase의 멤버가 아닌 값으로 설정된 경우입니다.
| |
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
digitWidth | 속성 |
digitWidth:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
이 텍스트에 사용되는 숫자 폭입니다. 이 속성에는 DigitWidth 상수를 사용합니다.
기본값은 DigitWidth.DEFAULT입니다.
이 속성의 값을 설정하려면 다음 문자열 값을 사용합니다.
| 문자열 값 | 설명 |
|---|---|
DigitWidth.DEFAULT | 기본 숫자 폭을 텍스트에 적용합니다. |
DigitWidth.PROPORTIONAL | 비례 숫자 폭을 텍스트에 적용합니다. |
DigitWidth.TABULAR | 표 형식 숫자 폭을 텍스트에 적용합니다. |
| 하위 클래스 | 속성 설정 효과 |
|---|---|
GraphicElement | 어떠한 영향도 미치지 않습니다. |
GroupElement | 어떠한 영향도 미치지 않습니다. |
TextElement | 요소의 텍스트에 사용되는 숫자 폭을 결정합니다. |
구현
public function get digitWidth():String public function set digitWidth(value:String):void오류
ArgumentError — DigitWidth의 멤버가 아닌 값으로 설정된 경우입니다.
| |
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
dominantBaseline | 속성 |
dominantBaseline:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
주 기준선으로 사용할 기준선 유형을 지정합니다. 주 기준선을 정렬 기준선과 정렬하여 줄의 요소에 대한 가로 위치를 결정합니다. 이 속성에는 TextBaseline 상수를 사용합니다.
요소의 내용이 기준선을 결정합니다. TextElement의 경우 글꼴과 포인트 크기가 기준선을 결정합니다. GraphicElement의 경우에는 요소의 높이가 기준선을 결정합니다.
기본값은 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 — TextBaseline의 멤버가 아닌 값으로 설정된 경우입니다.
| |
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
fontDescription | 속성 |
fontDescription:FontDescription| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
속성에서 글꼴을 설명하는 객체입니다.
기본값은 기본적으로 생성된 FontDescription 객체입니다.
fontDescription 속성을 설정하는 경우 제공된 FontDescription 객체가 잠깁니다. 즉, locked 속성이 true로 설정됩니다. 잠긴 FontDescription은 수정할 수 없습니다.
| 하위 클래스 | 속성 설정 효과 |
|---|---|
GraphicElement | 어떠한 영향도 미치지 않습니다. |
GroupElement | 어떠한 영향도 미치지 않습니다. |
TextElement | 요소의 텍스트에 사용되는 글꼴을 결정합니다. |
구현
public function get fontDescription():FontDescription public function set fontDescription(value:FontDescription):void오류
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
fontSize | 속성 |
fontSize:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
텍스트의 크기(픽셀 단위)입니다.
기본값은 12.0입니다.
| 하위 클래스 | 속성 설정 효과 |
|---|---|
GraphicElement | 어떠한 영향도 미치지 않습니다. |
GroupElement | 어떠한 영향도 미치지 않습니다. |
TextElement | 요소의 텍스트에 사용되는 픽셀 크기를 결정합니다. |
구현
public function get fontSize():Number public function set fontSize(value:Number):void오류
ArgumentError — 0보다 작은 값으로 설정된 경우입니다.
| |
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
kerning | 속성 |
kerning:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
커닝은 가독성을 향상시키기 위해 특정 문자 쌍 간의 픽셀을 조정합니다. 커닝은 커닝 표가 있는 모든 글꼴에 지원됩니다.
기본값은 Kerning.ON입니다.
이 속성에 대한 값을 설정하려면 Kerning 클래스에 다음 상수를 사용합니다.
| 문자열 값 | 설명 |
|---|---|
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 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
ligatureLevel | 속성 |
ligatureLevel:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
이 텍스트에 사용되는 합자 수준입니다. 합자는 둘 이상의 글자 모양을 결합하여 단일 글리프를 만드는 것입니다. 합자는 일반적으로 공통 구성 요소를 공유하는 연속된 문자(예: 'fi', 'fl' 또는 'ae' 글자 쌍)를 대체합니다. 합자는 라틴어 및 라틴어가 아닌 문자 세트에 모두 사용됩니다. 이 속성에는 LigatureLevel 상수를 사용합니다.
기본값은 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 — LigatureLevel의 멤버가 아닌 값으로 설정된 경우입니다.
| |
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
locale | 속성 |
locale:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
텍스트의 로캘입니다. 대/소문자 변형 및 모양을 제어합니다. 표준 로캘 식별자가 사용됩니다. 예를 들어 "en", "en_US" 및 "en-US"는 모두 영어를 나타내고 "ja"는 일본어를 나타냅니다. 로캘 코드 목록의 경우 iso639-2 코드 목록을 참조하십시오.
기본값은 "en"입니다.
| 하위 클래스 | 속성 설정 효과 |
|---|---|
GraphicElement | 어떠한 영향도 미치지 않습니다. |
GroupElement | 어떠한 영향도 미치지 않습니다. |
TextElement | 요소의 텍스트에 대한 변형과 모양을 결정합니다. |
구현
public function get locale():String public function set locale(value:String):void오류
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
locked | 속성 |
locked:Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5., Flash Lite 4 |
ElementFormat의 잠김 여부를 나타냅니다. true이면 ElementFormat을 수정할 수 없습니다. ElementFormat 객체의 잠기지 않은 복사본을 가져오려면 ElementFormat.clone()을 호출합니다.
구현
public function get locked():Boolean public function set locked(value:Boolean):void오류
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
textRotation | 속성 |
textRotation:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
개별 글리프에 적용되는 회전을 설정합니다. 이 속성에는 TextRotation 클래스에 정의된 상수를 사용합니다.
기본값은 TextRotation.AUTO입니다.
모든 글리프의 최종 회전은 , ElementFormat.textRotation, ContentElement.textRotation 및 TextBlock.lineRotation의 합으로 결정됩니다.
회전해야 가로 레이아웃에서 올바르게 표시되는 문자인 아시아권 언어 텍스트에 일반적으로 이 속성을 사용합니다. 이를 위해 TextRotation.AUTO를 TextBlock.lineRotation = TextRotation.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 — TextRotation의 멤버가 아닌 임의의 값으로 설정된 경우입니다.
| |
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
trackingLeft | 속성 |
trackingLeft:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5., Flash Lite 4 |
각 글리프의 왼쪽에 적용된 추적 또는 수동 커닝(픽셀 단위)입니다. kerning이 활성화된 경우 trackingLeft 값이 글꼴에 대한 커닝 표의 값에 추가됩니다. kerning이 활성화되지 않은 경우 trackingLeft 값이 수동 커닝 값으로 사용됩니다. 양수 및 음수 값을 모두 지원합니다.
일반적으로 적절한 추적 값은 trackingRight와 trackingLeft 사이에 있습니다. 그렇지 않으면 방향성이 혼합된 텍스트에서 한 쪽 양방향 경계에는 추적이 두 배로 적용되고 다른 쪽에는 전혀 적용되지 않습니다.
기본값은 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 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
trackingRight | 속성 |
trackingRight:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5., Flash Lite 4 |
각 글리프의 오른쪽에 적용된 추적 또는 수동 커닝(픽셀 단위)입니다. kerning이 활성화된 경우 trackingRight 값이 글꼴에 대한 커닝 표의 값에 추가됩니다. kerning이 활성화되지 않은 경우 trackingRight 값이 수동 커닝 값으로 사용됩니다. 양수 및 음수 값을 모두 지원합니다.
일반적으로 적절한 추적 값은 trackingRight와 trackingLeft 사이에 있습니다. 그렇지 않으면 방향성이 혼합된 텍스트에서 한 쪽 양방향 경계에는 추적이 두 배로 적용되고 다른 쪽에는 전혀 적용되지 않습니다.
기본값은 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 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
typographicCase | 속성 |
typographicCase:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
이 텍스트에 사용되는 입력 체계 대/소문자입니다. 이 속성에는 TypographicCase 클래스에 정의된 상수를 사용합니다.
기본값은 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 — TypographicCase의 멤버가 아닌 값으로 설정된 경우입니다.
| |
IllegalOperationError — ElementFormat 객체를 잠근(locked가 true) 상태에서 설정된 경우입니다.
|
관련 API 요소
생성자 세부 정보
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, Flash Lite 4 |
ElementFormat 객체를 만듭니다.
매개 변수fontDescription:FontDescription (default = null)null입니다. 글꼴 설명을 제공하지 않으면 기본 글꼴 설명이 만들어집니다.
| |
fontSize:Number (default = 12.0) | |
color:uint (default = 0x000000) | |
alpha:Number (default = 1.0)alpha 속성입니다.
| |
textRotation:String (default = "auto") | |
dominantBaseline:String (default = "roman") | |
alignmentBaseline:String (default = "useDominantBaseline") | |
baselineShift:Number (default = 0.0) | |
kerning:String (default = "on") | |
trackingRight:Number (default = 0.0) | |
trackingLeft:Number (default = 0.0) | |
locale:String (default = "en") | |
breakOpportunity:String (default = "auto") | |
digitCase:String (default = "default") | |
digitWidth:String (default = "default") | |
ligatureLevel:String (default = "common") | |
typographicCase:String (default = "default") |
오류
ArgumentError — 지정된 fontSize가 0보다 작습니다.
| |
ArgumentError — 지정된 textRotation이 TextRotation의 멤버가 아닙니다.
| |
ArgumentError — 지정된 dominantBaseline이 TextBaseline의 멤버가 아닙니다.
| |
ArgumentError — 지정된 alignmentBaseline이 TextBaseline의 멤버가 아닙니다.
| |
ArgumentError — 지정된 kerning이 Kerning의 멤버가 아닙니다.
| |
ArgumentError — 지정된 breakOpportunity가 BreakOpportunity의 멤버가 아닙니다.
| |
ArgumentError — 지정된 digitCase가 DigitCase의 멤버가 아닙니다.
| |
ArgumentError — 지정된 digitWidth가 DigitWidth의 멤버가 아닙니다.
| |
ArgumentError — 지정된 ligatureLevel이 LigatureLevel의 멤버가 아닙니다.
| |
ArgumentError — 지정된 typographicCase가 TypographicCase의 멤버가 아닙니다.
|
메서드 세부 정보
clone | () | 메서드 |
public function clone():ElementFormat| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
ElementFormat의 잠기지 않은 복사본을 만듭니다.
반환값ElementFormat — ElementFormat 객체의 잠기지 않은 복사본입니다.
|
예제 ( 예제 사용 방법 )
다음 예제에서는 ElementFormat 객체를 만들고 FontSize를 설정합니다. 새 TextElement를 만들고 이때 ElementFormat을 사용하여 잠급니다. TextElement는 TextBlock의 내용으로 사용됩니다. TextBlock에서 만들어진 텍스트 줄입니다.
ElementFormat 객체를 수정하려면 먼저 locked 속성을 선택합니다. true이면 clone() 메서드를 사용하여 ElementFormat의 잠기지 않은 복사본을 만들고 속성을 변경한 후 새 ElementFormat을 TextBlock에 다시 연결합니다. 줄을 다시 줄 바꿈할 때 새 줄에 새 글꼴 설정이 적용됩니다.
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, Flash Lite 4 |
fontDescription 및 fontSize로 지정한 글꼴의 전각 상자, 취소선 위치, 취소선 굵기, 밑줄 위치 및 밑줄 굵기를 설명하는 속성이 포함된 FontMetrics 객체를 반환합니다.
FontMetrics — fontDescription으로 지정한 글꼴의 속성을 설명하는 FontMetrics 객체입니다.
|
관련 API 요소
예제 ( 예제 사용 방법 )
다음은 지정된
FontDescription을 사용하여 ElementFormat 객체를 만들고 getFontMetrics 메서드를 사용하여 선택된 글꼴(24포인트)의 메트릭을 표시하는 예제입니다.
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);
ef1.fontSize = 24;
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의 내용으로 지정된 TextElement 객체에 새 ElementFormat을 할당합니다. TextElement의 ElementFormat을 변경해도 이전에 부모 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;
}
}
}
Tue Jun 12 2018, 03:17 PM Z