| 패키지 | flash.text.ime |
| 인터페이스 | public interface IIMEClient |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
인라인 IME를 지원하려면 ImeEvent.IME_START_COMPOSITION 이벤트의 imeClient 속성을 이 인터페이스를 구현하는 객체로 설정합니다.
다음은 IME 관련 API에서 자주 사용되는 용어입니다.
- 대화란 IME와 응용 프로그램 간의 통신 교환입니다. 대화가 진행되는 동안 구성이 한 번 이상 업데이트된 후 사용자에게 확인을 받습니다.
- 구성은 IME를 통해 사용자가 입력한 텍스트를 확인합니다. 선택한 범위, 절의 범위 등 연관된 입력 상태 정보가 포함됩니다.
- 절은 해당 입력이 선택된 상태인지 또는 변환된 상태인지를 나타내는 등 의미 정보를 공유할 수 있는 구성 범위입니다. 구성은 절을 포함하지 않거나 하나 이상의 절을 포함합니다.
관련 API 요소
공용 속성
| 속성 | 정의 주체 | ||
|---|---|---|---|
| compositionEndIndex : int [읽기 전용]
현재 편집 세션 텍스트(예: 문서로 확인되지 않은 인라인 세션의 모든 텍스트) 끝의 문자 인덱스 값으로, 0부터 시작합니다. | IIMEClient | ||
| compositionStartIndex : int [읽기 전용]
현재 편집 세션 텍스트(예: 문서로 확인되지 않은 인라인 세션의 모든 텍스트) 시작의 문자 인덱스 값으로, 0부터 시작합니다. | IIMEClient | ||
| selectionActiveIndex : int [읽기 전용]
현재 선택 영역에 있는 마지막 문자의 문자 인덱스 값(0부터 시작)입니다. | IIMEClient | ||
| selectionAnchorIndex : int [읽기 전용]
현재 선택 영역에 있는 첫 문자의 문자 인덱스 값(0부터 시작)입니다. | IIMEClient | ||
| verticalTextLayout : Boolean [읽기 전용]
구성 요소의 텍스트가 세로인지 여부를 나타냅니다. | IIMEClient | ||
공용 메서드
| 메서드 | 정의 주체 | ||
|---|---|---|---|
인라인 편집 세션을 종료하고 텍스트를 확인하려면 이 콜백을 사용합니다. | IIMEClient | ||
IME는 이 메서드를 사용하여 현재 IME 클라이언트로 편집되는 텍스트의 경계 상자를 쿼리합니다. | IIMEClient | ||
구성 요소에서 지정한 텍스트 범위를 가져옵니다. | IIMEClient | ||
구성 요소에서 선택한 텍스트의 범위를 설정합니다. | IIMEClient | ||
updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void
인라인 편집 세션의 내용을 업데이트하기 위한 콜백입니다. | IIMEClient | ||
이벤트
| 이벤트 | 요약 | 정의 주체 | ||
|---|---|---|---|---|
| 사용자가 IME(Input Method Editor)를 사용하기 시작할 때 전달됩니다. | IIMEClient | |||
| 사용자가 텍스트를 입력할 때 전달됩니다. | IIMEClient | |||
속성 세부 정보
compositionEndIndex | 속성 |
compositionStartIndex | 속성 |
selectionActiveIndex | 속성 |
selectionAnchorIndex | 속성 |
verticalTextLayout | 속성 |
메서드 세부 정보
confirmComposition | () | 메서드 |
public function confirmComposition(text:String = null, preserveSelection:Boolean = false):void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
인라인 편집 세션을 종료하고 텍스트를 확인하려면 이 콜백을 사용합니다.
매개 변수
text:String (default = null) | |
preserveSelection:Boolean (default = false) |
getTextBounds | () | 메서드 |
public function getTextBounds(startIndex:int, endIndex:int):Rectangle| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
IME는 이 메서드를 사용하여 현재 IME 클라이언트로 편집되는 텍스트의 경계 상자를 쿼리합니다. 이 메서드를 사용하여 후보 윈도우를 배치하고, IME를 지원하는 텍스트 필드 또는 기타 구성 요소 위에 마우스가 있을 때 IME 클라이언트에 마우스 커서를 설정합니다.
매개 변수
startIndex:int — 측정하는 경계 상자에서 텍스트 범위의 시작 위치를 지정하는 정수입니다.
| |
endIndex:int — 선택 사항으로, 측정하는 경계 상자에서 텍스트 범위의 끝 위치를 지정하는 정수입니다.
|
Rectangle — 지정된 텍스트 범위의 경계 상자이거나, 두 개의 인덱스 중 하나 또는 모두가 잘못된 경우 null입니다. startIndex가 endIndex보다 크거나 작은 경우 이 메서드는 동일한 값을 반환합니다. startIndex가 endIndex보다 크거나 작은지의 여부에 상관없이 동일한 값이 반환되어야 합니다.
|
getTextInRange | () | 메서드 |
public function getTextInRange(startIndex:int, endIndex:int):String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
구성 요소에서 지정한 텍스트 범위를 가져옵니다. 이 메서드는 IME를 다시 변환하는 동안 호출됩니다.
매개 변수
startIndex:int — 검색할 텍스트 범위의 시작 위치를 지정하는 정수입니다.
| |
endIndex:int — 검색할 텍스트 범위의 끝 위치를 지정하는 정수입니다.
|
String — 요청한 텍스트 또는 요청한 범위에 사용 가능한 텍스트가 없거나 인덱스 중 하나 또는 모두가 잘못된 경우 null입니다. startIndex가 endIndex보다 크거나 작은지 여부에 상관없이 같은 값이 반환되어야 합니다.
|
selectRange | () | 메서드 |
public function selectRange(anchorIndex:int, activeIndex:int):void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
구성 요소에서 선택한 텍스트의 범위를 설정합니다. 두 인수 중 하나가 경계를 벗어나는 경우 선택 영역을 변경하지 않아야 합니다.
매개 변수
anchorIndex:int — 선택 항목의 앵커 끝 문자에 대해 0부터 시작하는 인덱스 값입니다.
| |
activeIndex:int — 선택 항목의 활성 끝 문자에 대해 0부터 시작하는 인덱스 값입니다.
|
updateComposition | () | 메서드 |
public function updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
인라인 편집 세션의 내용을 업데이트하기 위한 콜백입니다. IME에서 편집 중인 텍스트가 변경되고 클라이언트가 해당 내용을 사용하여 전체 인라인 편집 세션을 다시 그릴 때마다 이 메서드가 호출됩니다.
매개 변수
text:String — IME의 인라인 편집 세션 텍스트를 포함합니다.
| |
attributes:Vector.<CompositionAttributeRange> — 장식 정보가 있는 구성 절의 배열을 포함합니다.
| |
compositionStartIndex:int — 텍스트 객체의 시작을 기준으로 한 인라인 세션의 시작입니다.
| |
compositionEndIndex:int — 텍스트 객체의 시작을 기준으로 한 인라인 세션의 끝입니다.
|
이벤트 세부 정보
imeStartComposition | 이벤트 |
이벤트 객체 유형:
속성 IMEEvent.type =
flash.events.IMEEvent속성 IMEEvent.type =
flash.events.IMEEvent.IME_START_COMPOSITION| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
사용자가 IME(Input Method Editor)를 사용하기 시작할 때 전달됩니다.
IME 텍스트 입력을 처리하려면 수신자가 IIMEClient 인터페이스를 구현하는 객체에 이벤트의imeClient 필드를 설정해야 합니다. imeClient가 설정되어 있지 않으면 런타임에서 비정규 IME 구성이 대신 사용되고, TEXT_INPUT 이벤트로 최종 구성을 보냅니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | IME 객체입니다. |
textInput | 이벤트 |
이벤트 객체 유형:
속성 TextEvent.type =
flash.events.TextEvent속성 TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
사용자가 텍스트를 입력할 때 전달됩니다. IME(Input Method Editor) 클라이언트의 경우 수신자는 이벤트 객체의 text 속성에 포함된 문자열을 현재 삽입 지점에 삽입해야 합니다.
textInput 이벤트 객체의 type 속성 값을 정의합니다.
참고: Delete 또는 백스페이스 키의 경우 이 이벤트가 전달되지 않습니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | true |
cancelable | true: preventDefault() 메서드를 호출하여 기본 비헤이비어를 취소합니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 문자를 입력하고 있는 텍스트 필드입니다. target은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
text | 사용자가 입력한 문자 또는 일련의 문자입니다. |
Tue Jun 12 2018, 03:17 PM Z