패키지 | flash.text |
클래스 | public final class StageText |
상속 | StageText EventDispatcher Object |
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
이 클래스를 사용하면 모바일 응용 프로그램은 모바일 장치에서 기본 테스트 입력 컨트롤을 사용하여 사용자 입력을 수집할 수 있습니다. 일반적으로 모바일 장치의 입력 컨트롤에는 테스크톱에는 존재하지 않는 광범위한 사용자 인터페이스 및 지원 비헤이비어가 있습니다. 예를 들어 대부분의 모바일 장치는 다음과 같은 텍스트 입력 기능을 지원합니다.
- 자동 완성
- 자동 수정
- 터치 기반 텍스트 선택
- 사용자 정의할 수 있는 소프트 키보드
기본 운영 체제나 운영 체제와 함께 제공되는 구성 요소 라이브러리가 기본 텍스트 입력 필드를 그립니다. 기본 텍스트 입력 필드는 동일한 장치에서 다른 응용 프로그램을 사용한 적이 있는 모든 사람에게 익숙한 경험을 제공합니다. 그러나 운영 체제가 플레이어 대신에 텍스트 입력 필드를 그리므로 포함된 글꼴을 사용할 수 없습니다.
AIR 프로파일 지원: 이 기능은 iOS 및 Android 플랫폼에서 지원됩니다. StageText는 Android 및 iOS 모바일 장치에서 기본 텍스트 입력 필드를 사용합니다. 다른 플랫폼에서 StageText는 Flash Runtime TextField를 사용합니다.
기본 입력이 사용될 경우 StageText 객체는 표시 객체가 아니며 Flash 표시 목록에 추가할 수 없습니다. 대신 stage
속성을 사용하여 스테이지에 직접 연결함으로써 StageText 객체를 표시합니다. 스테이지에 연결된 StageText 인스턴스는 Flash 표시 객체 위에 표시됩니다. viewPort
속성을 사용하여 렌더링 영역의 크기 및 위치를 제어합니다. 서로 다른 StageText 객체의 심도 순서를 제어할 수 있는 방법은 없습니다. 두 인스턴스를 겹치는 것은 바람직하지 않습니다.
StageText 객체는 포커스가 있을 경우 키보드 입력을 처리할 수 있는 첫 번째 기회를 갖게 됩니다. StageText 객체가 연결된 스테이지는 키보드 입력 이벤트를 전달하지 않습니다.
StageText 클래스가 모든 플랫폼에서 다른 기본 컨트롤을 래핑하므로 해당 기능이 지원되는 정도는 플랫폼마다 다릅니다. 기능이 지원될 경우 플랫폼마다 다르게 작동할 수 있습니다. 특정 플랫폼에서 특정 기능을 사용하려면 비헤이비어를 테스트하는 것이 가장 좋습니다. 기본 컨트롤이 사용되지 않는 데스크톱 플랫폼에서만 StageText 비헤이비어가 Flash 런타임 텍스트 비헤이비어와 유사합니다.
Apple TV의 StageText에 기본적으로 포커스가 지정됩니다. 애플리케이션에서 서로 다른 객체 간에 포커스를 관리하려면 아래 요소를 기록해 둡니다.
- StageText에서 기본 포커스를 무시하거나, 다른 표시 객체에 포커스를 할당하려면 stage.focus를 사용합니다.
- StageText에 포커스를 할당하려면 stageText.assignFocus()를 사용합니다.
속성 | 정의 주체 | ||
---|---|---|---|
autoCapitalize : String
장치가 사용자 입력에 자동 대문자 표시를 적용하는 방법을 제어합니다. | StageText | ||
autoCorrect : Boolean
장치가 사용자 입력의 맞춤법 또는 구두점 실수를 자동으로 수정하는지 여부를 나타냅니다. | StageText | ||
clearButtonMode : String [쓰기 전용]
현재 StageText 객체에 대한 clearButton의 모드입니다. | StageText | ||
color : uint
텍스트 색상을 지정합니다. | StageText | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
displayAsPassword : Boolean
텍스트 필드가 암호 텍스트 필드인지 여부를 나타냅니다. | StageText | ||
editable : Boolean
사용자가 텍스트 필드를 편집할 수 있는지 여부를 나타냅니다. | StageText | ||
fontFamily : String
현재 글꼴 집합의 이름을 나타냅니다. | StageText | ||
fontPosture : String
FontPosture 클래스에 정의된 상수를 사용하여 글꼴 모양을 지정합니다. | StageText | ||
fontSize : int
현재 글꼴 집합의 크기입니다(픽셀 단위). | StageText | ||
fontWeight : String
FontWeight 클래스에 정의된 상수를 사용하여 글꼴 굵기를 지정합니다. | StageText | ||
locale : String
텍스트의 로캘을 나타냅니다. | StageText | ||
maxChars : int
사용자가 텍스트 필드에 입력할 수 있는 최대 문자 수를 나타냅니다. | StageText | ||
multiline : Boolean [읽기 전용]
StageText 객체에 둘 이상의 텍스트 행이 표시될 수 있는지 여부를 나타냅니다. | StageText | ||
restrict : String
사용자가 텍스트 필드에 입력할 수 있는 문자 세트를 제한합니다. | StageText | ||
returnKeyLabel : String
소프트 키보드가 있는 장치에서 Return 키의 레이블을 나타냅니다. | StageText | ||
selectionActiveIndex : int [읽기 전용]
현재 선택 영역에 있는 마지막 문자의 문자 인덱스 값(0부터 시작)입니다. | StageText | ||
selectionAnchorIndex : int [읽기 전용]
현재 선택 영역에 있는 첫 문자의 문자 인덱스 값(0부터 시작)입니다. | StageText | ||
softKeyboardType : String
소프트 키보드의 모양을 제어합니다. | StageText | ||
stage : Stage
이 StageText 객체가 표시되는 스테이지입니다. | StageText | ||
text : String
텍스트 필드의 현재 텍스트입니다. | StageText | ||
textAlign : String
단락 정렬을 나타냅니다. | StageText | ||
viewPort : Rectangle
StageText 객체가 표시되는 스테이지의 영역입니다. | StageText | ||
visible : Boolean
StageText 객체를 표시할 수 있는지 여부를 나타냅니다. | StageText |
메서드 | 정의 주체 | ||
---|---|---|---|
StageText 객체를 만듭니다. | StageText | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | ||
StageText 객체에 포커스를 할당합니다. | StageText | ||
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | ||
StageText 객체를 지웁니다. | StageText | ||
비트맵에 StageText의 뷰포트를 그립니다. | StageText | ||
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | ||
첫 번째 및 마지막 문자의 인덱스 값에 지정된 텍스트를 선택합니다. | StageText | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher |
이벤트 | 요약 | 정의 주체 | ||
---|---|---|---|---|
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. | EventDispatcher | |||
텍스트 내용이 변경된 후 전달됩니다. | StageText | |||
null이 아닌 스테이지 및 비어 있지 않은 뷰포트를 설정한 후 전달됩니다. | StageText | |||
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. | EventDispatcher | |||
사용자가 텍스트를 편집하는 중이고 컨트롤에 키보드 포커스가 있을 때 전달됩니다. | StageText | |||
사용자가 텍스트를 더 이상 편집하지 않고 컨트롤에 더 이상 키보드 포커스가 없을 때 전달됩니다. | StageText | |||
사용자가 키를 누를 때 전달됩니다. | StageText | |||
사용자가 키를 놓을 때 전달됩니다. | StageText | |||
StageText 객체가 포커스를 획득하여 소프트 키보드가 활성화된 후 전달됩니다. | StageText | |||
StageText 객체가 포커스를 획득하여 소프트 키보드가 활성화되기 전에 전달됩니다. | StageText | |||
StageText 객체가 포커스를 잃어 소프트 키보드가 비활성화된 후 전달됩니다. | StageText |
autoCapitalize | 속성 |
autoCapitalize:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
장치가 사용자 입력에 자동 대문자 표시를 적용하는 방법을 제어합니다. 유효한 값은 AutoCapitalize 클래스에 상수로 정의됩니다.
- "none"
- "word"
- "sentence"
- "all"
모든 장치와 운영 체제에서 이 기능을 지원하지는 않으므로 이 속성은 기본 플랫폼에 대한 힌트일 뿐입니다.
참고: 텍스트가 편집 중이거나 텍스트에 포커스가 있는 동안 autoCapitalize
를 사용하도록 설정하면 포커스가 해제되었다가 다시 설정될 때까지 업데이트된 비헤이비어가 적용되지 않습니다.
기본값: AutoCapitalize.NONE.
구현
public function get autoCapitalize():String
public function set autoCapitalize(value:String):void
오류
ArgumentError — AutoCapitalize 의 멤버가 아닌 값으로 설정된 경우입니다.
|
관련 API 요소
autoCorrect | 속성 |
autoCorrect:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
장치가 사용자 입력의 맞춤법 또는 구두점 실수를 자동으로 수정하는지 여부를 나타냅니다.
모든 장치와 운영 체제에서 이 기능을 지원하지는 않으므로 이 속성은 기본 플랫폼에 대한 힌트일 뿐입니다.
참고: 텍스트가 편집 중이거나 텍스트에 포커스가 있는 동안 autoCorrect
를 사용하도록 설정하면 포커스가 해제되었다가 다시 설정될 때까지 업데이트된 비헤이비어가 적용되지 않습니다.
기본값: false.
구현
public function get autoCorrect():Boolean
public function set autoCorrect(value:Boolean):void
clearButtonMode | 속성 |
clearButtonMode:String
[쓰기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 23 |
현재 StageText 객체에 대한 clearButton의 모드입니다. 이 속성과 연관된 모드에는 다음과 같은 네 가지가 있습니다.
-
편집 도중 clearButton을 표시하려면:
StageTextClearButtonMode.WHILE_EDITING
-
clearButton을 표시하지 않으려면:
StageTextClearButtonMode.NEVER
-
clearButton을 항상 표시하려면:
StageTextClearButtonMode.ALWAYS
-
편집하지 않을 때만 clearButton을 표시하려면:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode
속성은 StageTextClearButtonMode.WHILE_EDITING
으로 설정됩니다.
참고: 이 속성은 iOS에서만 지원됩니다.
구현
public function set clearButtonMode(value:String):void
color | 속성 |
color:uint
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
텍스트 색상을 지정합니다. 세 개의 8비트 RGB 구성 요소를 포함하는 숫자로 텍스트 색상을 지정합니다. 첫 번째 구성 요소는 빨간색을, 두 번째 구성 요소는 녹색을, 세 번째 구성 요소는 파란색을 나타냅니다. 예를 들어 0xFF0000
은 빨간색을, 0x00FF00
은 녹색을, 0x0000FF
는 파란색을 지정합니다. 기본 텍스트 색상은 검은색(0x000000
)입니다.
기본값: 0x000000.
구현
public function get color():uint
public function set color(value:uint):void
displayAsPassword | 속성 |
displayAsPassword:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
텍스트 필드가 암호 텍스트 필드인지 여부를 나타냅니다. true
이면 텍스트 필드는 대체 문자(예: 별표)를 사용하여 입력 문자를 숨깁니다.
참고: 텍스트가 편집 중이거나 텍스트에 포커스가 있는 동안 displayAsPassword
를 사용하도록 설정하면 포커스가 해제되었다가 다시 설정될 때까지 업데이트된 비헤이비어가 적용되지 않습니다.
중요: iOS에서 이 속성의 값이 true
인 경우 여러 행 스테이지 텍스트 객체에 대체 문자가 표시되지 않습니다.
기본값: false.
구현
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | 속성 |
fontFamily | 속성 |
fontPosture | 속성 |
fontPosture:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
FontPosture 클래스에 정의된 상수를 사용하여 글꼴 모양을 지정합니다.
기본값: FontPosture.NORMAL.
구현
public function get fontPosture():String
public function set fontPosture(value:String):void
오류
ArgumentError — FontPosture 의 멤버가 아닌 값으로 설정된 경우입니다
|
관련 API 요소
fontSize | 속성 |
fontWeight | 속성 |
fontWeight:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
FontWeight 클래스에 정의된 상수를 사용하여 글꼴 굵기를 지정합니다.
기본값: FontWeight.NORMAL.
구현
public function get fontWeight():String
public function set fontWeight(value:String):void
오류
ArgumentError — FontWeight 의 멤버가 아닌 값으로 설정된 경우입니다
|
관련 API 요소
locale | 속성 |
locale:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
텍스트의 로캘을 나타냅니다. StageText는 표준 로캘 식별자를 사용합니다. 예를 들어 "en", "en_US" 및 "en-US"는 모두 영어를 나타내고 "ja"는 일본어를 나타냅니다. 로캘 코드 목록의 경우 iso639-2 코드 목록을 참조하십시오.
기본값: en.
구현
public function get locale():String
public function set locale(value:String):void
maxChars | 속성 |
multiline | 속성 |
restrict | 속성 |
restrict:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
사용자가 텍스트 필드에 입력할 수 있는 문자 세트를 제한합니다. 시스템은 왼쪽에서 오른쪽으로 restrict
문자열을 검색합니다.
restrict
값은 다음과 같은 텍스트 입력 제한 규칙을 지정합니다.
- 값이
null
인 경우 사용자는 모든 문자를 입력할 수 있습니다. - 값이 빈 문자열인 경우 사용자는 어떤 문자도 입력할 수 없습니다.
- 값이 문자가 포함된 문자열인 경우 사용자는 문자열의 문자만 입력할 수 있습니다.
- 값에 캐럿(^)이 포함된 경우 사용자는 캐럿 뒤에 있는 모든 문자를 입력할 수 없습니다.
- 값에서 하이픈(-) 문자를 사용하여 허용되는 입력 문자의 범위를 지정할 수 있습니다.
- 값에서
\u
이스케이프 시퀀스를 사용하여restrict
문자열을 구성할 수 있습니다.
특수 문자:
백슬래시를 사용하여 캐럿(^) 또는 대시(-) 문자를 입력합니다. 허용되는 백슬래시 시퀀스는 \-, \^ 및 \\입니다. 백슬래시는 문자열에서 실제 문자여야 합니다. ActionScript에서 백슬래시를 지정할 경우 이중 백슬래시를 사용합니다.
restrict
속성 설정 예제:
다음 예제에서는 사용자가 대시(-) 및 캐럿(^) 문자만 입력할 수 있습니다.
my_txt.restrict = "\\-\\^";
다음 예제에서는 사용자가 대문자, 공백 및 숫자만 입력할 수 있습니다.
my_txt.restrict = "A-Z 0-9";
다음 예제에서는 소문자만 제외됩니다.
my_txt.restrict = "^a-z";
다음 예제에서는 사용자가 대문자만 입력할 수 있지만 대문자 Q는 제외됩니다.
my_txt.restrict = "A-Z^Q";
다음 예제에서는 사용자가 ASCII 32(공백) 및 ASCII 126(물결 표시) 사이의 문자만 입력할 수 있습니다.
my_txt.restrict = "\u0020-\u007E";
참고: 제한 사항은 사용자 입력에만 적용되며 스크립트는 모든 문자를 텍스트 필드에 삽입할 수 있습니다.
기본값: null.
구현
public function get restrict():String
public function set restrict(value:String):void
returnKeyLabel | 속성 |
returnKeyLabel:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
소프트 키보드가 있는 장치에서 Return 키의 레이블을 나타냅니다. 사용 가능한 값은 ReturnKeyLabel
클래스에 정의된 상수입니다.
- "default"
- "done"
- "go"
- "next"
- "search"
모든 장치와 운영 체제에서 이러한 값을 지원하지는 않으므로 이 속성은 기본 플랫폼에 대한 힌트일 뿐입니다. 소프트 키보드가 없는 장치에서는 이 속성이 효과가 없습니다.
기본값: ReturnKeyLabel.DEFAULT.
구현
public function get returnKeyLabel():String
public function set returnKeyLabel(value:String):void
오류
ArgumentError — ReturnKeyLabel 의 멤버가 아닌 값으로 설정된 경우입니다.
|
관련 API 요소
selectionActiveIndex | 속성 |
selectionActiveIndex:int
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
현재 선택 영역에 있는 마지막 문자의 문자 인덱스 값(0부터 시작)입니다. 예를 들어 첫 번째 문자는 0, 두 번째 문자는 1입니다.
선택된 텍스트가 없으면 이 메서드는 삽입점을 반환합니다. StageText 인스턴스에 포커스가 없으면 이 메서드는 -1을 반환합니다.
iOS에서 이 속성은 여러 행이 아닌 StageText 객체에 대해 지원되지 않으며 -1을 반환합니다.
구현
public function get selectionActiveIndex():int
관련 API 요소
selectionAnchorIndex | 속성 |
selectionAnchorIndex:int
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
현재 선택 영역에 있는 첫 문자의 문자 인덱스 값(0부터 시작)입니다. 예를 들어 첫 번째 문자는 0, 두 번째 문자는 1입니다.
선택된 텍스트가 없으면 이 메서드는 삽입점을 반환합니다. StageText 인스턴스에 포커스가 없으면 이 메서드는 -1을 반환합니다.
iOS에서 이 속성은 여러 행이 아닌 StageText 객체에 대해 지원되지 않으며 -1을 반환합니다.
구현
public function get selectionAnchorIndex():int
관련 API 요소
softKeyboardType | 속성 |
softKeyboardType:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
소프트 키보드의 모양을 제어합니다.
소프트 키보드가 있는 장치는 예상되는 입력 유형과 일치하도록 키보드의 단추를 사용자 정의할 수 있습니다. 예를 들어 숫자 입력이 예상될 경우 장치는 SoftKeyboardType.NUMBER
를 사용하여 소프트 키보드에 숫자만 표시할 수 있습니다. 유효한 값은 SoftKeyboardType 클래스에 상수로 정의됩니다.
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
이러한 값은 장치가 현재 작업을 위한 최상의 키보드를 표시하는 데 도움이 되는 힌트로 사용됩니다.
기본값: SoftKeyboardType.DEFAULT.
구현
public function get softKeyboardType():String
public function set softKeyboardType(value:String):void
오류
ArgumentError — SoftKeyboardType 의 멤버가 아닌 값으로 설정된 경우입니다.
|
관련 API 요소
stage | 속성 |
text | 속성 |
textAlign | 속성 |
textAlign:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
단락 정렬을 나타냅니다. 유효한 값은 TextFormatAlign 클래스에 상수로 정의됩니다.
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
모든 플랫폼에서 모든 textAlign
값을 지원하지는 않습니다. 지원되지 않는 textAlign
값의 경우 플랫폼은 기본값(TextFormatAlign.START
)을 사용합니다.
기본값: TextFormatAlign.START.
구현
public function get textAlign():String
public function set textAlign(value:String):void
오류
ArgumentError — TextFormatAlign 의 멤버가 아닌 값으로 설정된 경우입니다.
|
관련 API 요소
viewPort | 속성 |
viewPort:Rectangle
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
StageText 객체가 표시되는 스테이지의 영역입니다. 기본값은 0 rect입니다.
구현
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
오류
RangeError — Rectangle 값이 잘못되었습니다.
|
visible | 속성 |
StageText | () | 생성자 |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
StageText 객체를 만듭니다.
StageText 객체는 스테이지에 연결되고 viewPort
속성이 설정되기 전에는 보이지 않습니다.
initOptions:flash.text:StageTextInitOptions (default = null )
|
assignFocus | () | 메서드 |
public function assignFocus():void
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
StageText 객체에 포커스를 할당합니다. 편집이 불가능한 객체의 경우 assignFocus()
는 아무 작업도 수행하지 않습니다.
dispose | () | 메서드 |
public function dispose():void
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
StageText 객체를 지웁니다.
dispose()
호출은 선택 사항입니다. 이 StageText 인스턴스에 대한 참조를 유지하지 않는 경우에는 가비지 수집의 대상이 됩니다. dispose()
를 호출하면 가비지 수집을 보다 일찍 또는 더 편리한 시간에 수행할 수 있습니다.
drawViewPortToBitmapData | () | 메서드 |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3.0 |
비트맵에 StageText의 뷰포트를 그립니다.
StageText 객체 위에 내용을 표시하기 위해 비트맵을 캡처하고 스테이지를 null
로 설정합니다.
이 비트맵은 일반적으로 viewport와 동일한 너비 및 높이를 가집니다. AIR 15.0을 처음 사용할 경우 플레이어가 HiDPI 디스플레이로 설정되어 있습니다. 원할 경우 이 비트맵의 너비 및 높이를 viewport 너비 및 높이의 contentsScaleFactor
배로 설정할 수 있습니다. 예를 들어, Mac Retina 디슬레이이에서 contentsScaleFactor
는 2입니다. 그 이유는 스테이지의 픽셀 해상도가 2배로 되어 있기 때문입니다. 따라서 비트맵은 viewport 크기의 2배가 됩니다.
Event.COMPLETE
이벤트 전에 이 메서드를 호출할 경우 뷰포트가 잘못 그려질 수 있습니다.
매개 변수
bitmap:BitmapData — StageText 뷰포트의 보이는 부분을 그릴 BitmapData 객체입니다.
|
오류
ArgumentError — 비트맵의 폭 또는 높이가 뷰포트의 폭 또는 높이와 다릅니다.
| |
Error — 비트맵이 null입니다.
|
selectRange | () | 메서드 |
public function selectRange(anchorIndex:int, activeIndex:int):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
첫 번째 및 마지막 문자의 인덱스 값에 지정된 텍스트를 선택합니다. anchorIndex
및 activeIndex
매개 변수에서 선택 영역의 첫 번째 및 마지막 문자를 지정합니다. 두 매개 변수 값이 같은 경우 이 메서드는 삽입점을 설정합니다.
iOS에서 여러 행이 아닌 StageText 객체의 경우 이 함수는 지원되지 않으며 항상 -1을 반환합니다. 텍스트 문자열 전체를 선택하여 이 메서드를 호출하면 선택 영역이 표시됩니다. 그러나 텍스트 문자열의 일부를 선택하여 이 메서드를 호출하면 선택 영역이 표시되지 않습니다.
일부 장치 또는 운영 체제의 경우 StageText 객체에 포커스가 있을 경우에만 선택 사항을 볼 수 있습니다.
매개 변수
anchorIndex:int — 선택 영역에서 첫 번째 문자의 0부터 시작하는 인덱스 값입니다(첫 번째 문자의 인덱스 값은 0임).
| |
activeIndex:int — 선택 영역에서 마지막 문자의 인덱스 값(0부터 시작)입니다.
|
관련 API 요소
change | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.CHANGE
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
텍스트 내용이 변경된 후 전달됩니다. 이 이벤트는 변경 시마다 전달되거나, 일련의 변경 사항이 완료될 때까지 전달되지 않을 수 있습니다.
Event.CHANGE
상수는 change
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | true |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 값이 수정된 객체입니다. target 은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
complete | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.COMPLETE
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
null이 아닌 스테이지 및 비어 있지 않은 뷰포트를 설정한 후 전달됩니다. 구현에서 StageText 객체의 레이아웃이 완료되었으며 이제 drawViewPortToBitmapData
메서드를 호출할 수 있다는 것을 나타냅니다. 플랫폼에 따라 이 이벤트는 stage
, viewPort
또는 둘 다의 설정과 함께 동기적 또는 비동기적으로 전달될 수 있습니다.
Event.COMPLETE
상수는 complete
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 로드가 완료된 네트워크 객체입니다. |
focusIn | 이벤트 |
flash.events.FocusEvent
속성 FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
사용자가 텍스트를 편집하는 중이고 컨트롤에 키보드 포커스가 있을 때 전달됩니다.
focusIn
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | true |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
keyCode | 0: keyFocusChange 이벤트에만 적용됩니다. |
relatedObject | 포커스 변경의 영향을 받는 보완적 InteractiveObject 인스턴스입니다. |
shiftKey | false : keyFocusChange 이벤트에만 적용됩니다. |
target | 방금 포커스를 받은 InteractiveObject 인스턴스입니다. target 은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다.
|
direction | 포커스가 할당된 방향입니다. 이 속성은 스테이지에 대한 assignFocus() 메서드의 direction 매개 변수 값을 보고합니다. 몇 가지 다른 방법으로 포커스가 변경되면 해당 값은 항상 FocusDirection.NONE 이 됩니다. focusIn 이벤트에만 적용됩니다. 다른 모든 포커스 이벤트의 경우 값이 FocusDirection.NONE 이 됩니다. |
focusOut | 이벤트 |
flash.events.FocusEvent
속성 FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
사용자가 텍스트를 더 이상 편집하지 않고 컨트롤에 더 이상 키보드 포커스가 없을 때 전달됩니다.
focusOut
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | true |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
keyCode | 0: keyFocusChange 이벤트에만 적용됩니다. |
relatedObject | 포커스 변경의 영향을 받는 보완적 InteractiveObject 인스턴스입니다. |
shiftKey | false : keyFocusChange 이벤트에만 적용됩니다. |
target | 방금 포커스를 잃은 InteractiveObject 인스턴스입니다. target 은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다.
|
keyDown | 이벤트 |
flash.events.KeyboardEvent
속성 KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
사용자가 키를 누를 때 전달됩니다.
특정 문자와 키 사이의 매핑은 장치 및 운영 체제마다 다릅니다. 이 이벤트 유형은 그러한 매핑이 일어난 후 IME의 처리가 이루어지기 전에 생성됩니다. IME는 중국어 표의 문자와 같이 표준 QWERTY 키보드로는 만들기 어려운 문자를 입력하는 데 유용합니다.
이 이벤트는 keyUp
이벤트 전에 발생합니다.
모든 키가 이 이벤트를 전달하지는 않습니다. 이 이벤트를 전달하는 키는 플랫폼마다 다릅니다.
AIR에서 이 이벤트를 취소하면 텍스트 필드에 문자가 입력되지 않습니다.
KeyboardEvent.KEY_DOWN
상수는 keyDown
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | true |
cancelable | AIR에서는 true 이고 Flash Player에서는 false 입니다. AIR에서 이 이벤트를 취소하면 텍스트 필드에 문자를 입력할 수 없습니다. |
charCode | 누르거나 놓은 키의 문자 코드 값입니다. |
commandKey | Mac에서 Command 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다 |
controlKey | Windows 및 Linux에서 Ctrl 키가 활성 상태이면 true 입니다. Mac에서 Control 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다 |
ctrlKey | Windows 및 Linux에서 Ctrl 키가 활성 상태이면 true 입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
keyCode | 누르거나 놓은 키의 키 코드 값입니다. |
keyLocation | 키보드에서 키의 위치입니다. |
shiftKey | true 이면 Shift 키가 활성 상태이고, false 이면 비활성 상태입니다. |
target | 포커스가 있는 InteractiveObject 인스턴스입니다. target 은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
keyUp | 이벤트 |
flash.events.KeyboardEvent
속성 KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
사용자가 키를 놓을 때 전달됩니다.
특정 문자와 키 사이의 매핑은 장치 및 운영 체제마다 다릅니다. 이 이벤트 유형은 그러한 매핑이 일어난 후 IME의 처리가 이루어지기 전에 생성됩니다. IME는 중국어 표의 문자와 같이 표준 QWERTY 키보드로는 만들기 어려운 문자를 입력하는 데 사용됩니다.
이 이벤트는 keyDown
이벤트 다음에 발생합니다.
모든 키가 이 이벤트를 전달하지는 않습니다. 이 이벤트를 전달하는 키는 플랫폼마다 다릅니다.
KeyboardEvent.KEY_UP
상수는 keyUp
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | true |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
charCode | 누르거나 놓은 키의 문자 코드 값이 포함되어 있습니다. |
commandKey | Mac에서 Command 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다 |
controlKey | Windows 및 Linux에서 Ctrl 키가 활성 상태이면 true 입니다. Mac에서 Control 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다 |
ctrlKey | Windows에서 Ctrl 키가 활성 상태이면 true 입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
keyCode | 누르거나 놓은 키의 키 코드 값입니다. |
keyLocation | 키보드에서 키의 위치입니다. |
shiftKey | true 이면 Shift 키가 활성 상태이고, false 이면 비활성 상태입니다. |
target | 포커스가 있는 InteractiveObject 인스턴스입니다. target 은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
softKeyboardActivate | 이벤트 |
flash.events.SoftKeyboardEvent
속성 SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
StageText 객체가 포커스를 획득하여 소프트 키보드가 활성화된 후 전달됩니다.
SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
상수는 소프트 키보드가 표시될 때 SoftKeyboardEvent 객체의 type
속성 값을 정의합니다. 이 이벤트의 경우 cancellable = false
입니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
relatedObjectVal | 이벤트와 관련된 표시 목록 객체에 대한 참조입니다. |
triggerTypeVal | 키보드 이벤트가 응용 프로그램에 의해 트리거되었는지 아니면 사용자에 의해 트리거되었는지를 나타냅니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
softKeyboardActivating | 이벤트 |
flash.events.SoftKeyboardEvent
속성 SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
StageText 객체가 포커스를 획득하여 소프트 키보드가 활성화되기 전에 전달됩니다.
SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
상수는 소프트 키보드가 표시되기 직전에 SoftKeyboardEvent 객체의 type
속성 값을 정의합니다. 이 이벤트의 경우 cancellable = true
입니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | 이벤트가 StageText 객체에 의해 전달되지 않을 경우 true 입니다. StageText 객체의 경우 이벤트를 취소할 수 없습니다. |
relatedObjectVal | 이벤트와 관련된 표시 목록 객체에 대한 참조입니다. |
triggerTypeVal | 키보드 이벤트가 응용 프로그램에 의해 트리거되었는지 아니면 사용자에 의해 트리거되었는지를 나타냅니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
softKeyboardDeactivate | 이벤트 |
flash.events.SoftKeyboardEvent
속성 SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3 |
StageText 객체가 포커스를 잃어 소프트 키보드가 비활성화된 후 전달됩니다.
SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
상수는 소프트 키보드가 눌리거나 숨겨질 때 SoftKeyboardEvent 객체의 type
속성 값을 정의합니다. 이 이벤트의 경우 cancellable = false
입니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
relatedObjectVal | 이벤트와 관련된 표시 목록 객체에 대한 참조입니다. |
triggerTypeVal | 키보드 이벤트가 응용 프로그램에 의해 트리거되었는지 아니면 사용자에 의해 트리거되었는지를 나타냅니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
Tue Jun 12 2018, 03:17 PM Z