This page was saved using jaction on 2006-09-04 8:34:07.
Address: http://flexdocs.kr/docs/flex2/langref/flash/text/TextFormat.html
Title: flash.text.TextFormat (Flex™ 2 레퍼런스 가이드)  •  Size: 56626
Packageflash.text
Classpublic class TextFormat
InheritanceTextFormat Inheritance Object
SubclassesUITextFormat

TextFormat 클래스는, 캐릭터 포맷 정보를 나타냅니다. TextFormat 클래스를 사용해, 텍스트 필드의 특정의 텍스트 포맷을 작성합니다. 정지 텍스트 필드 및 다이나믹 텍스트 필드의 양쪽 모두에 텍스트 포맷을 적용할 수 있습니다. TextFormat 클래스의 property는, 디바이스 폰트 및 포함하고 포함 폰트에 적용됩니다. 다만, 포함(Embed)되어 있는 폰트의 경우, 볼드와 이탤릭의 텍스트에는, 실제로 특정의 폰트가 필요합니다. 포함(Embed)되어 있는 폰트로 볼드 또는 이탤릭의 텍스트를 표시하는 경우는, 그 폰트의 볼드체 및 이탤릭체를 포함할 필요가 있습니다.

TextFormat object의 property를 설정하기 전에, constructor    new TextFormat() 를 사용해 TextFormat object를 작성할 필요가 있습니다. TextFormat property에 값을 설정하지 않는 경우는 Flash Player 고유의 포맷이 사용되므로, TextFormat property는 디폴트에서는 null 입니다. Flash Player 가 각 property에 대해서 사용하는 디폴트의 포맷은 다음과 같습니다.

Flash Player 의 디폴트의 property 포맷
(property의 값이null 의 경우)
align = "left"
blockIndent = 0
bold = false
bullet = false
color = 0x000000
font = "Times New Roman" (Mac OS X 에서의 디폴트 폰트는 Times)
indent = 0
italic = false
kerning = false
leading = 0
leftMargin = 0
letterSpacing = 0
rightMargin = 0
size = 12
tabStops = [] (empty의 배열)
target = "" (empty의 string)
underline = false
url = "" (empty의 string)

각 property의 디폴트의 포맷에 대해서는, 각 property의 설명에서도 설명합니다.

View the examples

See also

flash.text.TextField.setTextFormat()
flash.text.TextField.getTextFormat()


Public property
 property정의
  align : String
단락의 정렬의 설정을 나타냅니다.
TextFormat
  blockIndent : Object
블록의 인덴트를 픽셀 단위로 가리킵니다.
TextFormat
  bold : Object
텍스트를 볼드로 할지 어떨지를 지정합니다.
TextFormat
  bullet : Object
텍스트가 조목별로 나누어 쓴 글 리스트에 있을지 어떨지를 나타냅니다.
TextFormat
  color : Object
텍스트의 색을 나타냅니다.
TextFormat
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  font : String
이 텍스트 포맷에서의 텍스트 폰트명을 나타내는 string입니다.
TextFormat
  indent : Object
왼쪽 마진으로부터 단락의 선두 캐릭터까지의 인덴트를 나타냅니다.
TextFormat
  italic : Object
이 텍스트 포맷의 텍스트를 이탤릭으로 할지 어떨지를 나타냅니다.
TextFormat
  kerning : Object
kerning가 유효한가 (true) 무효인지 (false)를 나타내는 불리언 값입니다.
TextFormat
  leading : Object
행간의 수직의 행송를 나타내는 정수입니다.
TextFormat
  leftMargin : Object
단락의 왼쪽 마진을 픽셀 단위로 가리킵니다.
TextFormat
  letterSpacing : Object
모든 캐릭터간에 균등하게 배분되는 스페이스의 양을 나타내는 정수입니다.
TextFormat
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  rightMargin : Object
단락의 오른쪽 마진을 픽셀 단위로 가리킵니다.
TextFormat
  size : Object
이 텍스트 포맷에서의 텍스트의 포인트 크기입니다.
TextFormat
  tabStops : Array
custom tab stop를 부 이외의 정수의 배열로서 지정합니다.
TextFormat
  target : String
하이퍼 링크를 표시하는 타겟 윈도우를 나타냅니다.
TextFormat
  underline : Object
이 텍스트 포맷을 사용하는 텍스트에 언더라인을 표시하는지 (true), 또는 표시하지 않는가 (false)를 나타냅니다.
TextFormat
  url : String
이 텍스트 포맷의 텍스트의 대상 URL 를 나타냅니다.
TextFormat
Public Methods
 Methods정의
  TextFormat (font:String = null, size:Object = null, color:Object = null, bold:Object = null, italic:Object = null, underline:Object = null, url:String = null, target:String = null, align:String = null, leftMargin:Object = null, rightMargin:Object = null, indent:Object = null, leading:Object = null)
지정된 property를 사용해 TextFormat object를 작성합니다.
TextFormat
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
property의 상세
alignproperty
align:String   [read-write]

단락의 정렬의 설정을 나타냅니다. 지정할 수 있는 값은 TextFormatAlign 정수입니다.

디폴트치TextFormatAlign.LEFT.

Implements
    public function get align():String
    public function set align(value:String ):void

Throws
ArgumentError — 지정된 align 는, flash.text.TextFormatAlign 의 멤버가 아닙니다.

See also

blockIndentproperty 
blockIndent:Object   [read-write]

블록의 인덴트를 픽셀 단위로 가리킵니다. 블록의 인덴트는, 텍스트의 블록 전체, 즉 텍스트의 모든 행에 적용됩니다. 한편, 통상의 인덴트 (TextFormat.indent)는 각 단락의 선두행에게만 영향을 줍니다. 이 property가 null 인 경우, TextFormat object는 블록의 인덴트를 지정하지 않습니다. 블록의 인덴트는 0 입니다.

Implements
    public function get blockIndent():Object
    public function set blockIndent(value:Object ):void
boldproperty 
bold:Object   [read-write]

텍스트를 볼드로 할지 어떨지를 지정합니다. 디폴트치는 null 입니다. 이 경우, 볼드체는 사용되지 않습니다. 값이 true 의 경우는, 텍스트가 볼드체가 됩니다.

Implements
    public function get bold():Object
    public function set bold(value:Object ):void
bulletproperty 
bullet:Object   [read-write]

텍스트가 조목별로 나누어 쓴 글 리스트에 있을지 어떨지를 나타냅니다. 조목별로 나누어 쓴 글 리스트에서는, 텍스트의 각 단락이 인덴트 됩니다. 조목별로 나누어 쓴 글 심볼은, 각 단락의 선두행의 왼쪽으로 표시됩니다. 디폴트치는 null 입니다. 이 경우, 조목별로 나누어 쓴 글 리스트는 사용되지 않습니다.

Implements
    public function get bullet():Object
    public function set bullet(value:Object ):void
colorproperty 
color:Object   [read-write]

텍스트의 색을 나타냅니다. 예를 들어, 0xFF0000 는 빨강, 0x00FF00 는 초록 등, 3 개의 8 비트의 RGB 컴퍼넌트를 나타내는 수치입니다. 디폴트치는 null 로, Flash Player 에서는 흑 (0x000000)이 사용됩니다.

Implements
    public function get color():Object
    public function set color(value:Object ):void
fontproperty 
font:String   [read-write]

이 텍스트 포맷에서의 텍스트 폰트명을 나타내는 string입니다. 디폴트치는 null 로, Flash Player 에서는 텍스트에 Times New Roman 폰트가 사용됩니다.

Implements
    public function get font():String
    public function set font(value:String ):void
indentproperty 
indent:Object   [read-write]

왼쪽 마진으로부터 단락의 선두 캐릭터까지의 인덴트를 나타냅니다. 디폴트치는 null 로, 인덴트는 사용되지 않는 것을 나타냅니다.

Implements
    public function get indent():Object
    public function set indent(value:Object ):void

See also

italicproperty 
italic:Object   [read-write]

이 텍스트 포맷의 텍스트를 이탤릭으로 할지 어떨지를 나타냅니다. 디폴트치는 null 입니다. 이 경우, 이탤릭은 사용되지 않습니다.

Implements
    public function get italic():Object
    public function set italic(value:Object ):void
kerningproperty 
kerning:Object   [read-write]

kerning가 유효한가 (true) 무효인지 (false)를 나타내는 불리언 값입니다. kerning에서는, 읽기 쉽게 하기 위해서, 특정의 캐릭터 페어간에 픽셀을 조정합니다. 큰 폰트의 표제를 사용하는 경우 등, 필요한 경우에게만 사용할 필요가 있습니다. kerning는, 포함(Embed)되어 있는 폰트 에 대해서만 지원(support)되고 있습니다.

Verdana 나, Courier New 등의 등폭 폰트 등, 특정의 폰트에서는 kerning는 지원(support)되고 있지 않습니다.

디폴트치 null 는 kerning를 무효로 합니다. Implements
    public function get kerning():Object
    public function set kerning(value:Object ):void
leadingproperty 
leading:Object   [read-write]

행간의 수직의 행송를 나타내는 정수입니다. 디폴트치는 null 로, 사용되는 행송는 0 인 것을 나타냅니다.

Implements
    public function get leading():Object
    public function set leading(value:Object ):void
leftMarginproperty 
leftMargin:Object   [read-write]

단락의 왼쪽 마진을 픽셀 단위로 가리킵니다. 디폴트치는 null 입니다. 이 경우, 왼쪽 마진은 0 픽셀입니다.

Implements
    public function get leftMargin():Object
    public function set leftMargin(value:Object ):void
letterSpacingproperty 
letterSpacing:Object   [read-write]

모든 캐릭터간에 균등하게 배분되는 스페이스의 양을 나타내는 정수입니다. 이 값은, 각 캐릭터의 뒤의 보내에 추가되는 픽셀수를 나타냅니다. 디폴트치는 null 입니다. 이 경우, 0 픽셀의 캐릭터 간격이 사용됩니다.

Implements
    public function get letterSpacing():Object
    public function set letterSpacing(value:Object ):void
rightMarginproperty 
rightMargin:Object   [read-write]

단락의 오른쪽 마진을 픽셀 단위로 가리킵니다. 디폴트치는 null 입니다. 이 경우, 오른쪽 마진은 0 픽셀입니다.

Implements
    public function get rightMargin():Object
    public function set rightMargin(value:Object ):void
sizeproperty 
size:Object   [read-write]

이 텍스트 포맷에서의 텍스트의 포인트 크기입니다. 디폴트치는 null 입니다. 이 경우, 포인트 크기 12 가 사용됩니다.

Implements
    public function get size():Object
    public function set size(value:Object ):void
tabStopsproperty 
tabStops:Array   [read-write]

custom tab stop를 부 이외의 정수의 배열로서 지정합니다. 각 tab stop는 픽셀 단위로 지정합니다. custom tab stop를 지정하지 않으면 (null), tab stop는 디폴트의 4 (평균 캐릭터폭)가 됩니다.

Implements
    public function get tabStops():Array
    public function set tabStops(value:Array ):void
targetproperty 
target:String   [read-write]

하이퍼 링크를 표시하는 타겟 윈도우를 나타냅니다. 타겟 윈도우가 empty의 string인 경우, 텍스트는 디폴트의 타겟 윈도우 _self 에 표시됩니다. 커스텀명을 선택하는 일도, 다음의 4 개의 이름의 어느쪽이든을 선택할 수도 있습니다. _self 는 현재의 윈도우내의 현재의 프레임을 지정합니다. _blank 는 새로운 윈도우를 지정합니다. _parent 는 현재의 프레임의 부모를 지정합니다. _top 는 현재의 윈도우내의 톱 레벨의 프레임을 지정합니다. TextFormat.url property가 empty의 string 또는 null 의 경우는, 이 property를 취득 및 설정할 수 있습니다만, property는 어떤 영향도 미치지 않습니다.

Implements
    public function get target():String
    public function set target(value:String ):void

See also

underlineproperty 
underline:Object   [read-write]

이 텍스트 포맷을 사용하는 텍스트에 언더라인을 표시하는지 (true), 또는 표시하지 않는가 (false)를 나타냅니다. 이것은,<U> 태그에 의해 설정되는 언더라인과 닮아 있습니다만, 이 태그의 경우는 데센다가 올바르고 스킵 되지 않기 때문에, 진짜의 언더라인이 아닙니다. 디폴트치는 null 입니다. 이 경우, 언더라인은 사용되지 않습니다.

Implements
    public function get underline():Object
    public function set underline(value:Object ):void
urlproperty 
url:String   [read-write]

이 텍스트 포맷의 텍스트의 대상 URL 를 나타냅니다. url property가 empty의 string인 경우, 텍스트에는 하이퍼 링크가 없습니다. 디폴트치는 null 입니다. 이 경우, 텍스트에는 하이퍼 링크가 없습니다.

메모: 하이퍼 링크를 기능시키려면 , 텍스트 포맷을 할당할 수 있었던 텍스트를 htmlText property로 설정할 필요가 있습니다.

Implements
    public function get url():String
    public function set url(value:String ):void

See also

constructor    의 상세
TextFormat()constructor   
public 함수 TextFormat(font:String = null, size:Object = null, color:Object = null, bold:Object = null, italic:Object = null, underline:Object = null, url:String = null, target:String = null, align:String = null, leftMargin:Object = null, rightMargin:Object = null, indent:Object = null, leading:Object = null)

지정된 property를 사용해 TextFormat object를 작성합니다. 이 TextFormat object의 property를 변경해, 텍스트 필드의 포맷을 변경할 수 있습니다.

null 값를 설정한 Parameters는 미설정이 됩니다. 모든 Parameters는 옵션입니다. 생략 한 Parameters는 null 로서 다루어집니다.

Parameters
font:String (default = null) — 텍스트의 폰트명을 나타내는 string입니다.
 
size:Object (default = null) — 포인트 크기를 나타내는 정수입니다.
 
color:Object (default = null) — 이 텍스트 포맷을 사용하는 텍스트의 색. 예를 들어, 0xFF0000 는 빨강, 0x00FF00 는 초록 등, 3 개의 8 비트의 RGB 컴퍼넌트를 나타내는 수치입니다.
 
bold:Object (default = null) — 텍스트가 볼드체일지 어떨지를 나타내는 불리언 값입니다.
 
italic:Object (default = null) — 텍스트가 이탤릭체일지 어떨지를 나타내는 불리언 값입니다.
 
underline:Object (default = null) — 텍스트가 밑줄 첨부일지 어떨지를 나타내는 불리언 값입니다.
 
url:String (default = null) — 이 텍스트 포맷의 텍스트의 하이퍼 링크처인 URL 입니다. url 가 empty의 string인 경우, 텍스트에는 하이퍼 링크가 없습니다.
 
target:String (default = null) — 하이퍼 링크를 표시하는 타겟 윈도우입니다. 타겟 윈도우가 empty의 string인 경우, 텍스트는 디폴트의 타겟 윈도우 _self 에 표시됩니다. url Parameters에 empty의 string 또는 null 값를 지정했을 경우는, 이 property를 취득 또는 설정할 수 있습니다만, property에는 무슨 영향도 없습니다.
 
align:String (default = null) — 단락의 정렬의 설정을 나타내는 TextFormatAlign 값입니다.
 
leftMargin:Object (default = null) — 단락의 왼쪽 마진을 픽셀 단위로 가리킵니다.
 
rightMargin:Object (default = null) — 단락의 오른쪽 마진을 픽셀 단위로 가리킵니다.
 
indent:Object (default = null) — 왼쪽 마진으로부터 단락의 선두 캐릭터까지의 인덴트를 나타내는 정수입니다.
 
leading:Object (default = null) — 행간의 수직의 행송를 나타내는 수치입니다.
Examples

다음의 예는, TextFieldExample 클래스를 작성해, 텍스트 메세지를 디폴트의 장소 (x = 0, y = 0)에 표시합니다. 여기에서는 이하의 순서를 실행합니다.
  1. 타입 TextField 의 property label 가 작성됩니다.
  2. 클래스 constructor    은, 함수 configureLabel()
  3. 를 호출합니다.
  4. configureLabel() 함수는, 최초로 새로운 TextField object를 작성해, 그것을 label 에 할당해 그 Parameters를 이하와 같이 설정합니다.
    • 텍스트 필드를 왼쪽 가지런히 해로 합니다.
    • 배경의 칠을 유효하게 합니다.
    • 경계선을 유효하게 합니다.
  5. 다음에,configureLable() 는 로컬 변수 format 를 작성해, 그것을 새로운 TextFormat 인스턴스에 할당합니다. Parameters를 이하와 같이 설정합니다.
    • Font type = Verdana
    • Font Color = solid red
    • Font size = 10
    • Font underline = true
  6. label의 defaultTextFormat property는 format 로 설정되어 label 인스턴스가 표시 리스트에 추가됩니다. 처음은, 표시 리스트에는, 텍스트가 없는 텍스트 필드가, 흰 배경의 작은 박스로서 스테이지상에 표시되고 있습니다.
  7. 마지막으로, constructor    에 돌아와, label의 텍스트가,"Hello World and welcome to the show" 와 좌표 x = 0, y = 0 에 표시하도록(듯이) 설정됩니다. setLabel() 를 호출하는 것에 의해 실행됩니다.
 package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.text.TextFormat;


    public class TextFormatExample extends Sprite {
        private var label:TextField;

        public function TextFormatExample() {
            configureLabel();
            setLabel("Hello World and welcome to the show");
        }

        public function setLabel(str:String) :void {
            label.text = str;
        }

        private function configureLabel() :void {
            label = new TextField();
            label.autoSize = TextFieldAutoSize.LEFT;
            label.background = true;
            label.border = true;

            var format:TextFormat = new TextFormat();
            format.font = "Verdana";
            format.color = 0xFF0000;
            format.size = 10;
            format.underline = true;

            label.defaultTextFormat = format;
            addChild(label);
        }
    }
}






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/flash/text/TextFormat.html