패키지 | spark.core |
인터페이스 | public interface IEditableText extends IDisplayText , IEventDispatcher |
구현자 | RichEditableText, StyleableStageText, StyleableTextField |
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
속성 | 정의 주체 | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
이 표시 객체의 현재 액세스 가능성 옵션입니다. | IEditableText | ||
displayAsPassword : Boolean
텍스트 필드가 암호 텍스트 필드인지 여부를 지정합니다. | IEditableText | ||
editable : Boolean
Flag that indicates whether the text is editable. | IEditableText | ||
enabled : Boolean
Whether the component can accept user interaction. | IEditableText | ||
focusEnabled : Boolean
Indicates whether the component can receive focus when tabbed to. | IEditableText | ||
horizontalScrollPosition : Number
The horizontal scroll position of the text. | IEditableText | ||
isTruncated : Boolean [읽기 전용]
A flag that indicates whether the text has been truncated. | IDisplayText | ||
lineBreak : String
Controls word wrapping within the text. | IEditableText | ||
maxChars : int
사용자가 입력하여 텍스트 필드에 포함될 수 있는 최대 문자 수입니다. | IEditableText | ||
multiline : Boolean
필드가 여러 행 텍스트 필드인지 여부를 나타냅니다. | IEditableText | ||
restrict : String
사용자가 텍스트 필드에 입력할 수 있는 문자 세트를 나타냅니다. | IEditableText | ||
selectable : Boolean
텍스트 필드를 선택할 수 있는지 여부를 나타내는 부울 값입니다. | IEditableText | ||
selectionActivePosition : int [읽기 전용]
The active, or last clicked position, of the selection. | IEditableText | ||
selectionAnchorPosition : int [읽기 전용]
The anchor, or first clicked position, of the selection. | IEditableText | ||
tabIndex : int
SWF 파일에서 객체의 탭 순서를 지정합니다. | IEditableText | ||
text : String
The text displayed by this text component. | IDisplayText | ||
verticalScrollPosition : Number
The vertical scroll position of the text. | IEditableText |
메서드 | 정의 주체 | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | IEventDispatcher | ||
Appends the specified text to the end of the text component,
as if you had clicked at the end and typed. | IEditableText | ||
이벤트를 이벤트 흐름으로 전달합니다. | IEventDispatcher | ||
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | IEventDispatcher | ||
Inserts the specified text into the text component
as if you had typed it. | IEditableText | ||
EventDispatcher 객체에서 리스너를 제거합니다. | IEventDispatcher | ||
Scroll so the specified range is in view. | IEditableText | ||
Selects all of the text. | IEditableText | ||
Selects a specified range of characters. | IEditableText | ||
Set focus to this text field. | IEditableText | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | IEventDispatcher |
accessibilityProperties | 속성 |
accessibilityProperties:AccessibilityProperties
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
이 표시 객체의 현재 액세스 가능성 옵션입니다. accessibilityProperties
속성 또는 accessibilityProperties
의 필드 중 하나를 수정할 경우 Accessibility.updateProperties()
메서드를 호출하여 변경 사항을 적용해야 합니다.
참고: Flash 제작 환경에서 만든 객체의 경우 accessibilityProperties
값은 해당 객체의 액세스 가능성 패널에서 입력한 정보로 미리 채워집니다.
구현
public function get accessibilityProperties():AccessibilityProperties
public function set accessibilityProperties(value:AccessibilityProperties):void
displayAsPassword | 속성 |
displayAsPassword:Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
텍스트 필드가 암호 텍스트 필드인지 여부를 지정합니다. 이 속성의 값이 true
이면 텍스트 필드가 암호 텍스트 필드로 간주되며 실제 문자 대신 별표를 사용하여 입력 문자가 숨겨집니다. 이 값이 false
이면 텍스트 필드가 암호 텍스트 필드로 간주되지 않습니다. 암호 모드를 사용하면 잘라내기 및 복사 명령과 해당 키보드 단축키가 작동하지 않습니다. 이 보안 메커니즘은 악의적인 사용자가 단축키를 사용하여 아무도 없는 컴퓨터에서 암호를 알아낼 수 없게 합니다.
구현
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | 속성 |
enabled | 속성 |
enabled:Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
Whether the component can accept user interaction. After setting the enabled
property to false
, some components still respond to mouse interactions such
as mouseOver. As a result, to fully disable UIComponents,
you should also set the value of the mouseEnabled
property to false
.
If you set the enabled
property to false
for a container, Flex dims the color of the container and of all
of its children, and blocks user input to the container
and to all of its children.
구현
public function get enabled():Boolean
public function set enabled(value:Boolean):void
focusEnabled | 속성 |
focusEnabled:Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
Indicates whether the component can receive focus when tabbed to.
You can set focusEnabled
to false
when a UIComponent is used as a subcomponent of another component
so that the outer component becomes the focusable entity.
If this property is false
, focus is transferred to
the first parent that has focusEnable
set to true
.
The default value is true
, except for the
spark.components.Scroller component.
For that component, the default value is false
.
구현
public function get focusEnabled():Boolean
public function set focusEnabled(value:Boolean):void
horizontalScrollPosition | 속성 |
lineBreak | 속성 |
maxChars | 속성 |
maxChars:int
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
사용자가 입력하여 텍스트 필드에 포함될 수 있는 최대 문자 수입니다. 스크립트를 사용하면 maxChars
에서 허용하는 것보다 많은 텍스트를 삽입할 수 있습니다. maxChars
속성은 사용자가 입력할 수 있는 텍스트의 양만 나타냅니다. 이 속성의 값이 0
이면 사용자는 텍스트를 무제한 입력할 수 있습니다.
구현
public function get maxChars():int
public function set maxChars(value:int):void
multiline | 속성 |
multiline:Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
필드가 여러 행 텍스트 필드인지 여부를 나타냅니다. 값이 true
이면 텍스트 필드가 여러 행이고, 값이 false
이면 텍스트 필드가 한 행입니다. TextFieldType.INPUT
유형 필드에서 multiline
값은 Enter
키를 누를 때 새 행이 만들어지는지 여부를 결정합니다. 값이 false
이면 Enter
키가 무시됩니다. TextField
(multiline
값이 false
)에 텍스트를 붙여 넣으면 텍스트에서 개행 문자가 제거됩니다.
구현
public function get multiline():Boolean
public function set multiline(value:Boolean):void
restrict | 속성 |
restrict:String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
사용자가 텍스트 필드에 입력할 수 있는 문자 세트를 나타냅니다. 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";
구현
public function get restrict():String
public function set restrict(value:String):void
selectable | 속성 |
selectable:Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
텍스트 필드를 선택할 수 있는지 여부를 나타내는 부울 값입니다. 값이 true
이면 텍스트를 선택할 수 있습니다. selectable
속성은 텍스트 필드를 편집할 수 있는지 여부가 아니라 텍스트 필드를 선택할 수 있는지 여부를 제어합니다. 동적 텍스트 필드는 편집할 수 없더라도 선택할 수 있습니다. 동적 텍스트 필드를 선택할 수 없게 하면 사용자가 텍스트를 선택할 수 없습니다.
selectable
을 false
로 설정하면 텍스트 필드의 텍스트가 마우스나 키보드의 선택 명령에 응답하지 않으며 [복사] 명령으로 텍스트를 복사할 수 없습니다. selectable
을 true
로 설정하면 마우스나 키보드로 텍스트 필드의 텍스트를 선택할 수 있고 [복사] 명령으로 텍스트를 복사할 수 있습니다. 텍스트 필드가 입력 텍스트 필드가 아닌 동적 텍스트 필드인 경우에도 이러한 방법으로 텍스트를 선택할 수 있습니다.
구현
public function get selectable():Boolean
public function set selectable(value:Boolean):void
selectionActivePosition | 속성 |
selectionActivePosition:int
[읽기 전용] 언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
The active, or last clicked position, of the selection. If the implementation does not support selection anchor this is the last character of the selection.
구현
public function get selectionActivePosition():int
selectionAnchorPosition | 속성 |
selectionAnchorPosition:int
[읽기 전용] 언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
The anchor, or first clicked position, of the selection. If the implementation does not support selection anchor this is the first character of the selection.
구현
public function get selectionAnchorPosition():int
tabIndex | 속성 |
tabIndex:int
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
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;TLFTextField 객체(
tlfInstance1
, tlfInstance2
및 tlfInstance3
)의 세 인스턴스에 대한 기본 설정에서 탭 순서를 반대로 바꾸려면 다음을 사용합니다.
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
구현
public function get tabIndex():int
public function set tabIndex(value:int):void
verticalScrollPosition | 속성 |
appendText | () | 메서드 |
public function appendText(text:String):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
Appends the specified text to the end of the text component, as if you had clicked at the end and typed.
An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.
매개 변수
text:String — The text to be appended.
|
insertText | () | 메서드 |
public function insertText(text:String):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
Inserts the specified text into the text component as if you had typed it.
If a range was selected, the new text replaces the selected text. If there was an insertion point, the new text is inserted there.
An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.
매개 변수
text:String — The text to be inserted.
|
scrollToRange | () | 메서드 |
public function scrollToRange(anchorPosition:int, activePosition:int):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
Scroll so the specified range is in view.
매개 변수
anchorPosition:int — The anchor position of the selection range.
| |
activePosition:int — The active position of the selection range.
|
selectAll | () | 메서드 |
public function selectAll():void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
Selects all of the text.
selectRange | () | 메서드 |
public function selectRange(anchorIndex:int, activeIndex:int):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
Selects a specified range of characters.
If either position is negative, it will deselect the text range.
매개 변수
anchorIndex:int — The character position specifying the end
of the selection that stays fixed when the selection is extended.
| |
activeIndex:int — The character position specifying the end
of the selection that moves when the selection is extended.
|
setFocus | () | 메서드 |
public function setFocus():void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10.1, AIR 2.0 |
Set focus to this text field.
Tue Jun 12 2018, 03:17 PM Z