IUITextField  - AS3 Flex

true로 설정하면 텍스트 필드에 포커스가 없는 경우 Flash Player에서 텍스트 필드의 선택 영역이 회색으로 강조 표시됩니다. false로 설정하면 텍스트 필드에 포커스가 없는 경우 Flash Player에서 텍스트 필드의 선택 영역이 강조 표시되지 않습니다.

이 텍스트 필드에 사용되는 앤티앨리어싱 유형입니다. 이 속성에는 flash.text.AntiAliasType 상수를 사용합니다. 이 설정은 글꼴이 포함되어 있는 경우(embedFonts 속성이 true로 설정)에만 제어할 수 있습니다. 기본 설정은 flash.text.AntiAliasType.NORMAL입니다.

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

텍스트 필드의 자동 크기 조절 및 정렬을 제어합니다. TextFieldAutoSize 상수에 사용할 수 있는 값은 TextFieldAutoSize.NONE(기본값), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT 및 TextFieldAutoSize.CENTER입니다.

autoSize를 기본값인 TextFieldAutoSize.NONE으로 설정하면 크기가 자동으로 조절되지 않습니다.

autoSize를 TextFieldAutoSize.LEFT로 설정하면 텍스트가 왼쪽 정렬로 간주되어 텍스트 필드의 왼쪽 여백이 고정되며 텍스트 필드의 단일 행에 대한 모든 크기 조절이 오른쪽 여백에 적용됩니다. 텍스트에 "\n" 또는 "\r" 등의 줄 바꿈이 포함된 경우 아래쪽 크기가 다음 텍스트 행에 맞게 조절됩니다. 또한 wordWrap을 true로 설정하면 텍스트 필드의 아래쪽만 크기가 조절되고 오른쪽은 고정됩니다.

autoSize를 TextFieldAutoSize.RIGHT로 설정하면 텍스트가 오른쪽 정렬로 간주되어 텍스트 필드의 오른쪽 여백이 고정되며 텍스트 필드의 단일 행에 대한 모든 크기 조절이 왼쪽 여백에 적용됩니다. 텍스트에 "\n" 또는 "\r" 등의 줄 바꿈이 포함된 경우 아래쪽 크기가 다음 텍스트 행에 맞게 조절됩니다. 또한 wordWrap을 true로 설정하면 텍스트 필드의 아래쪽만 크기가 조절되고 왼쪽은 고정됩니다.

autoSize를 TextFieldAutoSize.CENTER로 설정하면 텍스트가 가운데 정렬로 간주되어 텍스트 필드의 단일 행에 대한 모든 크기 조절이 오른쪽 여백과 왼쪽 여백에 균등하게 적용됩니다. 텍스트에 "\n" 또는 "\r" 등의 줄 바꿈이 포함된 경우 아래쪽 크기가 다음 텍스트 행에 맞게 조절됩니다. 또한 wordWrap을 true로 설정하면 텍스트 필드의 아래쪽만 크기가 조절되고 왼쪽과 오른쪽은 고정됩니다.

텍스트 필드에 배경 칠이 있는지 여부를 지정합니다. true이면 텍스트 필드에 배경 칠이 있습니다. false이면 텍스트 필드에 배경 칠이 없습니다. 텍스트 필드의 배경색을 설정하려면 backgroundColor 속성을 사용합니다.

텍스트 필드의 배경색입니다. 기본값은 0xFFFFFF(흰색)입니다. 이 속성은 현재 배경이 없어도 가져오거나 설정할 수 있지만 색상을 표시하려면 텍스트 필드의 background 속성을 true로 설정해야 합니다.

텍스트 필드에 테두리가 있는지 여부를 지정합니다. true이면 텍스트 필드에 테두리가 있습니다. false이면 텍스트 필드에 테두리가 없습니다. 테두리 색상을 설정하려면 borderColor 속성을 사용합니다.

텍스트 필드의 테두리 색상입니다. 기본값은 0x000000(검정)입니다. 이 속성은 현재 테두리가 없어도 가져오거나 설정할 수 있지만 색상을 표시하려면 텍스트 필드의 border 속성을 true로 설정해야 합니다.

지정된 텍스트 필드에서 현재 맨 아래에 표시되는 행을 나타내는 정수 인덱스(1부터 시작)입니다. 텍스트 필드는 텍스트 블록 위의 "윈도우"라고 이해할 수 있습니다. scrollV 속성은 윈도우에서 맨 위에 표시되는 행의 인덱스(1부터 시작)입니다.

scrollV 및 bottomScrollV로 지정한 행 사이의 모든 텍스트가 현재 텍스트 필드에 표시됩니다.

삽입점(캐럿) 위치의 인덱스입니다. 삽입점이 표시되지 않는 경우 이 값은 필드에 포커스가 돌아올 때 삽입점이 놓일 위치입니다. 이 위치는 일반적으로 삽입점이 마지막으로 있었던 위치이며, 필드가 포커스를 가진 적이 없는 경우에는 0입니다.

선택 범위 인덱스는 0부터 시작합니다. 예를 들어 첫 위치는 0이고 두 번째 위치는 1과 같은 식입니다.

HTML 텍스트가 있는 텍스트 필드에서 공백 문자, 줄 바꿈 등의 불필요한 공백을 제거할지 여부를 지정하는 부울 값입니다. 기본값은 false입니다. condenseWhite 속성은 htmlText 속성이 설정된 텍스트에만 적용되고 text 속성이 설정된 텍스트에는 적용되지 않습니다. 텍스트에 text 속성을 설정하면 condenseWhite가 무시됩니다.

condenseWhite를 true로 설정한 경우 텍스트 필드에 줄 바꿈을 배치하려면 <BR> 및 <P> 등의 표준 HTML 명령을 사용합니다.

condenseWhite 속성은 htmlText 속성을 설정하기 전에 설정해야 합니다.

replaceSelectedText() 메서드로 삽입한 텍스트 또는 사용자가 입력한 텍스트 등 새로 삽입되는 텍스트에 적용할 서식을 지정합니다.

참고: setSelection() 및 replaceSelectedText()로 대체할 문자를 선택할 때는 마지막 문자까지 포함하여 텍스트를 선택하는 경우에만 defaultTextFormat이 적용됩니다. 예를 들면 다음과 같습니다.

     var my_txt:TextField new TextField();
     my_txt.text = "Flash Macintosh version";
     var my_fmt:TextFormat = new TextFormat();
     my_fmt.color = 0xFF0000;
     my_txt.defaultTextFormat = my_fmt;
     my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied
     my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied
     my_txt.replaceSelectedText("Windows version");
     

defaultTextFormat 속성에 액세스할 때 반환되는 TextFormat 객체에는 정의된 모든 속성이 포함됩니다. null인 속성은 없습니다.

참고: 텍스트 필드에 스타일 시트가 적용된 경우에는 이 속성을 설정할 수 없습니다.

텍스트 필드가 암호 텍스트 필드인지 여부를 지정합니다. 이 속성의 값이 true이면 텍스트 필드가 암호 텍스트 필드로 간주되며 실제 문자 대신 별표를 사용하여 입력 문자가 숨겨집니다. 이 값이 false이면 텍스트 필드가 암호 텍스트 필드로 간주되지 않습니다. 암호 모드를 사용하면 잘라내기 및 복사 명령과 해당 키보드 단축키가 작동하지 않습니다. 이 보안 메커니즘은 악의적인 사용자가 단축키를 사용하여 아무도 없는 컴퓨터에서 암호를 알아낼 수 없게 합니다.

이 객체에서 doubleClick 이벤트를 받을지 여부를 지정합니다. 기본값은 false로, InteractiveObject 인스턴스가 doubleClick 이벤트를 기본적으로 수신하지 않음을 의미합니다. doubleClickEnabled 속성이 true로 설정된 경우 인스턴스는 해당 경계 안에서 doubleClick 이벤트를 수신합니다. InteractiveObject 인스턴스의 mouseEnabled 속성도 doubleClick 이벤트를 수신하려면 해당 객체에 대해 true로 설정되어야 합니다.

이 속성을 설정할 때 전달되는 이벤트는 없습니다. addEventListener() 메서드를 사용하여 doubleClick 이벤트에 대한 이벤트 리스너를 추가해야 합니다.

포함된 글꼴 외곽선을 사용하여 렌더링할지 여부를 지정합니다. false이면 Flash Player에서 장치 글꼴을 사용하여 텍스트 필드를 렌더링합니다.

텍스트 필드의 embedFonts 속성을 true로 설정한 경우 텍스트 필드에 적용된 TextFormat 객체의 font 속성을 사용하여 해당 텍스트의 글꼴을 지정해야 합니다. 지정한 글꼴이 SWF 파일에 포함되어 있지 않으면 텍스트가 표시되지 않습니다.

이 객체에서 포커스 사각형을 표시할지 여부를 지정합니다. true, false 또는 null이라는 세 가지 값 중 하나를 사용할 수 있습니다. true 및 false 값은 예상대로 작동하여 포커스 사각형의 표시 여부를 지정합니다. null 값은 이 객체가 Stage의 stageFocusRect 속성을 사용함을 나타냅니다.

이 텍스트 필드에 사용되는 격자 맞춤의 유형입니다. 이 속성은 텍스트 필드의 flash.text.AntiAliasType 속성을 flash.text.AntiAliasType.ADVANCED로 설정한 경우에만 적용됩니다.

격자 맞춤의 유형은 Flash Player에서 굵은 가로 및 세로 선을 픽셀 격자에 맞출지, 하위 픽셀 격자에 맞출지 아니면 전혀 맞추지 않을지를 결정하는 데 사용됩니다.

flash.text.GridFitType 속성에는 다음 문자열 값을 사용할 수 있습니다.

텍스트 필드 내용의 HTML 표현이 들어 있습니다.

Flash Player에서는 다음과 같은 HTML 태그를 지원합니다.

Flash Player 및 AIR에서는 다음과 같은 HTML 엔터티를 지원합니다.

Flash Player 및 AIR는 &(ASCII 앰퍼샌드) 및 €(Unicode € 심볼) 등의 명시적 문자 코드도 지원합니다.

If true, the paddingLeft and paddingRight styles will not add space around the text of the component.

The beginning of this UITextField's chain of inheriting styles. The getStyle() method accesses inheritingStyles[styleName] to search the entire prototype-linked chain. This object is set up by the initProtoChain() method. You typically never need to access this property directly.

텍스트 필드의 문자 수입니다. 탭(\t) 같은 문자는 한 문자로 계산됩니다.

사용자가 입력하여 텍스트 필드에 포함될 수 있는 최대 문자 수입니다. 스크립트를 사용하면 maxChars에서 허용하는 것보다 많은 텍스트를 삽입할 수 있습니다. maxChars 속성은 사용자가 입력할 수 있는 텍스트의 양만 나타냅니다. 이 속성의 값이 0이면 사용자는 텍스트를 무제한 입력할 수 있습니다.

scrollH의 최대값입니다.

scrollV의 최대값입니다.

이 객체가 마우스 또는 기타 사용자 입력, 메시지를 수신할지 여부를 지정합니다. 기본값은 true로, 표시 목록에 있는 InteractiveObject 인스턴스가 기본적으로 마우스 이벤트 또는 기타 사용자 입력 이벤트를 수신함을 의미합니다. mouseEnabled를 false로 설정하면 인스턴스가 마우스 이벤트(또는 키보드 이벤트와 같은 기타 사용자 입력 이벤트)를 수신하지 않습니다. 표시 목록에 있는 이 인스턴스의 자식은 영향을 받지 않습니다. 표시 목록에 있는 특정 객체의 모든 자식에 대한 mouseEnabled 비헤이비어를 변경하려면 flash.display.DisplayObjectContainer.mouseChildren을 사용합니다.

이 속성을 설정할 때 전달되는 이벤트는 없습니다. 대화형 기능을 만들려면 addEventListener() 메서드를 사용해야 합니다.

사용자가 텍스트 필드를 클릭하고 마우스 휠을 굴릴 때 여러 줄 텍스트 필드가 자동으로 스크롤되는지 여부를 나타내는 부울 값입니다. 기본적으로 이 값은 true입니다. 이 속성은 마우스 휠로 텍스트 필드의 내용을 스크롤하지 못하도록 하거나 고유한 텍스트 필드 스크롤 방식을 구현할 때 유용합니다.

필드가 여러 행 텍스트 필드인지 여부를 나타냅니다. 값이 true이면 텍스트 필드가 여러 행이고, 값이 false이면 텍스트 필드가 한 행입니다. TextFieldType.INPUT 유형 필드에서 multiline 값은 Enter 키를 누를 때 새 행이 만들어지는지 여부를 결정합니다. 값이 false이면 Enter 키가 무시됩니다. TextField(multiline 값이 false)에 텍스트를 붙여 넣으면 텍스트에서 개행 문자가 제거됩니다.

Depth of this object in the containment hierarchy. This number is used by the measurement and layout code. The value is 0 if this component is not on the DisplayList.

The beginning of this UITextField's chain of non-inheriting styles. The getStyle() method accesses nonInheritingStyles[styleName] method to search the entire prototype-linked chain. This object is set up by the initProtoChain() method. You typically never need to access this property directly.

Unlike textHeight, this returns a non-zero value even when the text is empty. In this case, it returns what the textHeight would be if the text weren't empty.

여러 행 텍스트 필드의 텍스트 행 수를 정의합니다. wordWrap 속성을 true로 설정한 경우 텍스트가 줄 바꿈되면 행 수가 증가합니다.

사용자가 텍스트 필드에 입력할 수 있는 문자 세트를 나타냅니다. restrict 속성 값이 null이면 아무 문자나 입력할 수 있습니다. restrict 속성 값이 빈 문자열이면 어떠한 문자도 입력할 수 없습니다. restrict 속성 값이 문자열이면 이 문자열에 있는 문자만 텍스트 필드에 입력할 수 있습니다. 문자열은 왼쪽에서 오른쪽으로 검색되고, 하이픈(-) 문자를 사용하여 범위를 지정할 수 있습니다. 사용자 상호 작용만 제한되며 스크립트를 통해서는 텍스트 필드에 모든 텍스트를 입력할 수 있습니다. 이 속성은 속성 관리자의 글꼴 포함 옵션과 동기화되지 않습니다.

문자열이 캐럿(^)으로 시작되면 기본적으로 모든 문자가 허용되며 문자열에서 캐럿 이후의 문자는 허용되는 문자 세트에서 제외됩니다. 문자열이 캐럿(^)으로 시작되지 않으면 기본적으로 어떠한 문자도 허용되지 않으며 문자열에 있는 문자만 허용되는 문자 세트에 포함됩니다.

다음 예제에서는 대문자, 공백 및 숫자만 텍스트 필드에 입력할 수 있습니다.

     my_txt.restrict = "A-Z 0-9";
     

다음 예제에서는 소문자를 제외한 모든 문자를 포함합니다.

     my_txt.restrict = "^a-z";
     

백슬래시를 사용하여 ^ 또는 -를 입력할 수 있습니다. 또한 \-, \^, \\ 등의 백슬래시 시퀀스를 사용할 수 있습니다. 백슬래시는 문자열의 실제 문자여야 하므로 ActionScript에 지정될 때는 이중 백슬래시를 사용해야 합니다. 예를 들어 다음 코드에는 대시(-)와 캐럿(^)만 포함됩니다.

     my_txt.restrict = "\\-\\^";
     

문자열의 아무 위치에서나 ^를 사용하여 포함 문자와 제외 문자를 전환할 수 있습니다. 다음 코드는 대문자 Q를 제외한 대문자만 포함합니다.

     my_txt.restrict = "A-Z^Q";
     

\u 이스케이프 시퀀스를 사용하여 restrict 문자열을 구성할 수 있습니다. 다음 코드는 ASCII 32(공백)에서 ASCII 126(물결 표시)까지의 문자만 포함합니다.

     my_txt.restrict = "\u0020-\u007E";
     

현재 가로 스크롤 위치입니다. scrollH 속성이 0이면 텍스트가 가로 방향으로 스크롤되지 않은 것입니다. 이 속성 값은 가로 위치를 픽셀 단위로 나타내는 정수입니다.

가로 스크롤 단위는 픽셀인 반면 세로 스크롤 단위는 행입니다. 가로 스크롤을 픽셀 단위로 측정하는 이유는 일반적으로 사용하는 대부분의 글꼴은 간격이 비례적이므로 문자마다 폭이 다를 수 있기 때문입니다. Flash Player에서 세로 스크롤을 행 단위로 수행하는 이유는 일반적으로 텍스트의 행 일부가 아닌 전체 텍스트 행을 표시하는 것이 유용하기 때문입니다. 한 행에 여러 글꼴이 사용되는 경우 행의 높이는 사용 중인 가장 큰 글꼴에 맞게 조정됩니다.

참고: scrollH 속성은 0부터 시작하는 반면 scrollV 세로 스크롤 속성은 1부터 시작합니다.

텍스트 필드에서 텍스트의 수직 위치입니다. scrollV 속성은 긴 텍스트에서 특정 단락으로 이동하거나 스크롤 텍스트 필드를 만들 때 유용합니다.

세로 스크롤 단위는 행인 반면 가로 스크롤 단위는 픽셀입니다. 표시된 첫 번째 행이 텍스트 필드의 첫 행인 경우 scrollV는 0이 아니라 1로 설정됩니다. 가로 스크롤을 픽셀 단위로 측정하는 이유는 대부분의 글꼴은 간격이 비례적이므로 문자마다 폭이 다를 수 있기 때문입니다. Flash에서 세로 스크롤을 행 단위로 수행하는 이유는 일반적으로 텍스트의 행 일부가 아닌 전체 텍스트 행을 표시하는 것이 유용하기 때문입니다. 한 행에 여러 글꼴이 사용되는 경우 행의 높이는 사용 중인 가장 큰 글꼴에 맞게 조정됩니다.

텍스트 필드를 선택할 수 있는지 여부를 나타내는 부울 값입니다. 값이 true이면 텍스트를 선택할 수 있습니다. selectable 속성은 텍스트 필드를 편집할 수 있는지 여부가 아니라 텍스트 필드를 선택할 수 있는지 여부를 제어합니다. 동적 텍스트 필드는 편집할 수 없더라도 선택할 수 있습니다. 동적 텍스트 필드를 선택할 수 없게 하면 사용자가 텍스트를 선택할 수 없습니다.

selectable을 false로 설정하면 텍스트 필드의 텍스트가 마우스나 키보드의 선택 명령에 응답하지 않으며 [복사] 명령으로 텍스트를 복사할 수 없습니다. selectable을 true로 설정하면 마우스나 키보드로 텍스트 필드의 텍스트를 선택할 수 있고 [복사] 명령으로 텍스트를 복사할 수 있습니다. 텍스트 필드가 입력 텍스트 필드가 아닌 동적 텍스트 필드인 경우에도 이러한 방법으로 텍스트를 선택할 수 있습니다.

현재 선택 영역에 있는 첫 문자의 문자 인덱스 값(0부터 시작)입니다. 예를 들어 첫 번째 문자는 0, 두 번째 문자는 1입니다. 선택한 텍스트가 없으면 이 속성은 caretIndex의 값입니다.

현재 선택 영역에 있는 마지막 문자의 문자 인덱스 값(0부터 시작)입니다. 예를 들어 첫 번째 문자는 0, 두 번째 문자는 1입니다. 선택한 텍스트가 없으면 이 속성은 caretIndex의 값입니다.

이 텍스트 필드의 글리프 가장자리 선명도입니다. 이 속성은 텍스트 필드의 flash.text.AntiAliasType 속성을 flash.text.AntiAliasType.ADVANCED로 설정한 경우에만 적용됩니다. sharpness의 범위는 -400에서 400 사이입니다. sharpness를 이 범위에서 벗어난 값으로 설정하면 속성이 범위 내의 가장 가까운 값(-400 또는 400)으로 설정됩니다.

텍스트 필드에 스타일 시트를 연결합니다. 스타일 시트를 만드는 방법에 대한 자세한 내용은 StyleSheet 클래스 및 ActionScript 3.0 개발자 안내서를 참조하십시오.

언제든지 텍스트 필드에 연결된 스타일 시트를 변경할 수 있습니다. 사용 중인 스타일 시트를 변경하면 텍스트 필드가 새 스타일 시트를 사용하여 다시 그려집니다. 스타일 시트를 null 또는 undefined로 설정하여 스타일 시트를 제거할 수 있습니다. 사용 중인 스타일 시트를 제거하면 스타일 시트 없이 텍스트 필드가 다시 그려집니다.

참고: 스타일 시트를 제거하면 TextField.text 및 TextField.htmlText의 내용이 변경되어 이전에 스타일 시트에 의해 적용된 서식이 통합됩니다. 서식 지정 없이 원래 TextField.htmlText 내용을 유지하려면 스타일 시트를 제거하기 전에 값을 변수에 저장하십시오.

이 객체가 탭 순서에 있는지 여부를 지정합니다. 이 객체가 탭 순서에 있으면 값이 true이고, 그렇지 않으면 false입니다. 기본적으로 이 값은 다음 경우를 제외하고 false입니다.

• SimpleButton 객체의 경우 값은 true입니다.
• type = "input"인 TextField 객체의 경우 값은 true입니다.
• buttonMode = true인 Sprite 객체나 MovieClip 객체의 경우 값은 true입니다.

SWF 파일에서 객체의 탭 순서를 지정합니다. tabIndex 속성의 기본값은 -1로, 해당 객체에 대해 설정된 탭 인덱스가 없음을 의미합니다.

SWF 파일에 현재 표시되어 있는 임의의 객체가 tabIndex 속성을 포함하고 있으면 자동 탭 순서는 사용되지 않으며, 해당 SWF 파일에 있는 객체의 tabIndex 속성에서 탭 순서가 계산됩니다. 사용자 정의 탭 순서에는 tabIndex 속성을 가진 객체만 포함됩니다.

tabIndex 속성은 음수가 아닌 정수가 될 수 있습니다. 객체는 tabIndex 속성에 따라 오름차순으로 정렬됩니다. tabIndex 값이 1인 객체가 tabIndex 값이 2인 객체보다 앞에 옵니다. 여러 객체에 대해 같은 tabIndex 값을 사용해서는 안 됩니다.

tabIndex 속성이 정의하는 사용자 정의 탭 순서는 평면적입니다. 즉, SWF 파일에서 객체의 계층 관계가 무시됩니다. SWF 파일에서 tabIndex 속성을 갖는 모든 객체는 탭 순서대로 정렬되며, 이 탭 순서는 tabIndex 값의 순서에 따라 결정됩니다.

참고: TLFTextField 인스턴스에 대한 탭 순서를 설정하려면 TLFTextField의 표시 객체 자식을 InteractiveObject로 형 변환한 다음 tabIndex 속성을 설정합니다. 예를 들면 다음과 같습니다.

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

텍스트 필드의 현재 텍스트인 문자열입니다. 각 행은 캐리지 리턴 문자('\r', ASCII 13)로 구분됩니다. 이 속성에는 HTML 태그를 제외한 텍스트 필드의 서식 없는 텍스트가 포함됩니다.

HTML 형식의 텍스트를 가져오려면 htmlText 속성을 사용합니다.

참고: 스타일 시트가 텍스트 필드에 적용되면 text 속성의 내용은 HTML로 해석됩니다.

텍스트 필드의 16진수 형식 텍스트 색상입니다. 16진수 색상 시스템은 여섯 자리 숫자를 사용하여 색상 값을 나타냅니다. 각 자리 숫자에는 16개의 값 또는 문자를 사용할 수 있습니다. 문자 범위는 0-9 및 A-F입니다. 예를 들어 검정은 0x000000이고 흰색은 0xFFFFFF입니다.

텍스트의 높이(픽셀 단위)입니다.

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

이 텍스트 필드의 글리프 가장자리 두께입니다. 이 속성은 flash.text.AntiAliasType을 flash.text.AntiAliasType.ADVANCED로 설정한 경우에만 적용됩니다.

thickness의 범위는 -200에서 200 사이입니다. thickness를 이 범위에서 벗어난 값으로 설정하면 속성이 범위 내의 가장 가까운 값(-200 또는 200)으로 설정됩니다.

텍스트 필드의 유형입니다. 값으로는 TextFieldType 상수 중 하나가 사용됩니다. TextFieldType.DYNAMIC은 사용자가 편집할 수 없는 동적 텍스트 필드를, TextFieldType.INPUT은 사용자가 편집할 수 있는 입력 텍스트 필드를 지정합니다.

텍스트와 함께 텍스트 서식을 복사하여 붙여 넣을지 여부를 지정합니다. true로 설정하면 텍스트 필드 간에 텍스트를 복사하여 붙여 넣을 때 Flash Player에서 정렬, 굵게, 기울임체 등의 서식을 함께 복사하여 붙여 넣습니다. 이때 복사하여 붙여 넣는 원본 텍스트 필드와 대상 텍스트 필드 모두에서 useRichTextClipboard를 true로 설정해야 합니다. 기본값은 false입니다.

텍스트 필드에 자동 줄 바꿈이 사용되는지 여부를 나타내는 부울 값입니다. wordWrap 값이 true이면 텍스트 필드에 줄 바꿈이 적용되고, 값이 false이면 텍스트 필드에 줄 바꿈이 적용되지 않습니다. 기본값은 false입니다.

newText 매개 변수에 지정된 문자열을 텍스트 필드의 텍스트 끝에 추가합니다. 이 메서드는 추가 할당(+=)을 text 속성(예: someTextField.text += moreText)에 하는 것보다 효율적입니다. 특히 내용이 많은 텍스트 필드의 경우에 유용합니다.

매개 변수

문자의 경계 상자인 사각형을 반환합니다.

매개 변수

x 및 y 매개 변수로 지정된 점에 있는 문자의 인덱스 값(0부터 시작)을 반환합니다.

매개 변수

지정된 문자 인덱스와 같은 단락에 있는 첫 문자의 인덱스를 반환합니다.

매개 변수

<img> 태그를 사용하여 HTML 형식 텍스트 필드에 추가한 이미지 또는 SWF 파일에 지정된 id의 DisplayObject 참조를 반환합니다. <img> 태그의 형식은 다음과 같습니다.

   <img src = 'filename.jpg' id = 'instanceName' >

매개 변수

x 및 y 매개 변수로 지정된 점에 있는 행의 인덱스 값(0부터 시작)을 반환합니다.

매개 변수

charIndex 매개 변수로 지정된 문자가 들어 있는 행의 인덱스 값(0부터 시작)을 반환합니다.

매개 변수

특정 텍스트 행의 문자 수를 반환합니다.

매개 변수

지정된 텍스트 행에 대한 메트릭 정보를 반환합니다.

매개 변수

lineIndex 매개 변수로 지정된 행에 있는 첫 문자의 문자 인덱스를 반환합니다.

매개 변수

lineIndex 매개 변수로 지정된 행의 텍스트를 반환합니다.

매개 변수

지정된 문자 인덱스가 포함된 단락의 길이를 반환합니다. 이 길이의 기준은 전달된 문자 인덱스가 아니라 getFirstCharInParagraph()로 반환되는 단락의 첫 문자입니다.

매개 변수

Gets a style property that has been set anywhere in this component's style lookup chain.

This same method is used to get any kind of style property, so the value returned can be a Boolean, String, Number, int, uint (for an RGB color), Class (for a skin), or any kind of object. Therefore the return type is simply specified as *.

If you are getting a particular style property, you know its type and often want to store the result in a variable of that type. No casting from * to that type is necessary.

var backgroundColor:uint = getStyle("backgroundColor");

If the style property has not been set anywhere in the style lookup chain, the value returned by getStyle() is undefined. Note that undefined is a special value that is not the same as false, "", NaN, 0, or null. No valid style value is ever undefined. You can use the method IStyleManager2.isValidStyleValue() to test whether the value was set.

매개 변수

beginIndex 및 endIndex 매개 변수로 지정된 텍스트 범위에 대한 서식 정보가 들어 있는 TextFormat 객체를 반환합니다. 결과 TextFormat 객체에는 지정된 텍스트 전체에서 공통되는 속성만 설정됩니다. 텍스트의 각 위치마다 값이 다름을 의미하는 혼합 속성은 값이 null입니다.

이러한 매개 변수에 값을 지정하지 않으면 텍스트 필드의 텍스트 전체에 이 메서드가 적용됩니다.

다음 표에서는 가능한 세 가지 사용법을 설명합니다.

매개 변수

Returns a UITextFormat object that contains formatting information for this component. This method is similar to the getTextFormat() method of the flash.text.TextField class, but it returns a UITextFormat object instead of a TextFormat object.

The UITextFormat class extends the TextFormat class to add the text measurement methods measureText() and measureHTMLText().

현재 선택 내용을 value 매개 변수의 내용으로 바꿉니다. 텍스트는 현재 기본 문자 서식과 기본 단락 서식을 사용하여 현재 선택 위치에 삽입됩니다. 이 텍스트는 HTML로 간주되지 않습니다.

replaceSelectedText() 메서드를 사용하면 나머지 텍스트의 문자 및 단락 서식을 손상시키지 않고 텍스트를 삽입 및 삭제할 수 있습니다.

참고: 이 메서드는 텍스트 필드에 스타일 시트가 적용된 경우 작동하지 않습니다.

매개 변수

beginIndex 및 endIndex 매개 변수로 지정한 문자 범위를 newText 매개 변수의 내용으로 대체합니다. 설계했던 대로 beginIndex에서 endIndex-1까지의 텍스트가 대체됩니다.

참고: 이 메서드는 텍스트 필드에 스타일 시트가 적용된 경우 작동하지 않습니다.

매개 변수

Sets the font color of the text.

매개 변수

Sets the focus to this component. The component can in turn pass focus to a subcomponent.

Note: Only the TextInput and TextArea controls show a highlight when this method sets the focus. All controls show a highlight when the user tabs to the control.

beginIndex 및 endIndex 매개 변수로 지정된 첫 번째 및 마지막 문자의 인덱스 값으로 지정된 텍스트를 선택된 상태로 설정합니다. 두 매개 변수 값이 서로 같은 경우 이 메서드는 caretIndex 속성을 설정한 것과 같이 삽입점을 설정합니다.

매개 변수