InputMethod QML Type

QML에서 입력 방식을 생성하기 위한 기본 유형. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• inputContext : InputContext
• inputEngine : InputEngine

신호

• selectionListActiveItemChanged(int type, int index)
• selectionListChanged(int type)
• selectionListsChanged() (since QtQuick.VirtualKeyboard 2.2)

방법

• bool clickPreeditText(int cursorPosition) (since QtQuick.VirtualKeyboard 2.4)
• list<int> inputModes(string locale)
• bool keyEvent(int key, string text, int modifiers)
• list<int> patternRecognitionModes() (since QtQuick.VirtualKeyboard 2.0)
• bool reselect(int cursorPosition, int reselectFlags) (since QtQuick.VirtualKeyboard 2.0)
• void reset()
• var selectionListData(int type, int index, int role)
• int selectionListItemCount(int type)
• void selectionListItemSelected(int type, int index)
• list<int> selectionLists()
• bool setInputMode(string locale, int inputMode)
• bool setTextCase(int textCase)
• Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo) (since QtQuick.VirtualKeyboard 2.0)
• bool traceEnd(Trace trace) (since QtQuick.VirtualKeyboard 2.0)
• void update()

상세 설명

InputMethod 유형을 사용하면 InputEngine 에 할당할 수 있는 사용자 정의 입력 방법을 만들 수 있습니다.

속성 설명

inputContext : InputContext [read-only]

입력 컨텍스트.

inputEngine : InputEngine [read-only]

입력 엔진.

Signal 문서

selectionListActiveItemChanged(int type, int index)

입력 방식은 type 로 식별되는 선택 목록에서 현재 index 가 변경되었을 때 이 신호를 발생시킵니다.

selectionListChanged(int type)

이 입력 방식은 선택 목록의 내용이 변경될 때 이 신호를 발생시킵니다. ` type ` 매개변수는 어떤 선택 목록이 변경되었는지를 지정합니다.

[since QtQuick.VirtualKeyboard 2.2] selectionListsChanged()

이 입력 방식은 선택 목록의 유형이 변경되었을 때 이 신호를 발생시킵니다. 이 신호는 ` selectionLists()` 메서드의 호출을 트리거하여, 입력 방식이 선택 목록의 유형을 업데이트할 수 있도록 합니다.

이 신호는 QtQuick.VirtualKeyboard 2.2에서 도입되었습니다.

메서드 문서

[since QtQuick.VirtualKeyboard 2.4] bool clickPreeditText(int cursorPosition)

사용자가 cursorPosition 에서 편집 전 텍스트를 클릭하면 호출됩니다.

이 함수는 이벤트를 처리하는 경우 true 를 반환해야 합니다. 그렇지 않은 경우, 입력은 추가 처리를 위해 reselect()로 다시 전달됩니다.

이 메서드는 QtQuick.VirtualKeyboard 2.4에서 도입되었습니다.

list<int> inputModes(string locale)

locale 의 입력 모드 목록을 반환합니다.

bool keyEvent(int key, string text, int modifiers)

이 메서드의 목적은 입력 엔진에서 생성된 키 이벤트를 처리하는 것입니다.

key 매개변수는 처리할 키의 코드를 지정합니다. 키 코드는 대소문자를 구분하지 않습니다. text 매개변수에는 해당 키에 해당하는 유니코드 텍스트가 포함됩니다. modifiers 매개변수에는 key 에 적용되는 키 수정자가 포함됩니다.

이 메서드는 키 이벤트가 성공적으로 처리된 경우 ` true `를 반환합니다. 반환 값이 ` false`인 경우, 키 이벤트는 추가 처리를 위해 기본 입력 방식으로 리디렉션됩니다.

[since QtQuick.VirtualKeyboard 2.0] list<int> patternRecognitionModes()

지원되는 패턴 인식 모드 목록을 반환합니다.

이 메서드는 입력 엔진에 의해 호출되어 지원되는 패턴 인식 모드 목록을 조회합니다.

이 메서드는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.

[since QtQuick.VirtualKeyboard 2.0] bool reselect(int cursorPosition, int reselectFlags)

이 메서드는 커서 위치( cursorPosition)에 있는 단어를 다시 선택하려고 시도합니다. 커서 위치에 대한 단어 선택 규칙은 ‘단어 선택 방식( reselectFlags )’에서 정의됩니다.

• InputEngine.WordBeforeCursor 커서 앞의 단어를 활성화합니다. 이 플래그만 단독으로 사용될 경우, 단어는 커서 위치에서 정확히 끝나야 합니다.
• InputEngine.WordAfterCursor 커서 뒤의 단어를 활성화합니다. 이 플래그만 단독으로 사용될 경우, 단어는 커서 위치에서 정확히 시작해야 합니다.
• InputEngine.WordAtCursor 커서가 위치한 단어를 활성화합니다. 이 플래그는 위의 플래그들을 조합한 것이나, 단어가 커서 위치에서 시작하거나 끝날 수는 없다는 점이 다릅니다.

단어가 성공적으로 재선택된 경우, 이 메서드는 ` true `를 반환합니다.

이 메서드는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.

void reset()

이 메서드는 해당 입력 방식이 재설정되어야 할 때 입력 엔진에 의해 호출됩니다. 입력 방식은 내부 상태만 재설정해야 합니다. ` update()` 메서드와의 주요 차이점은, `reset()`은 입력 방식의 상태만 수정하며 입력 컨텍스트는 수정해서는 안 된다는 점입니다.

var selectionListData(int type, int index, int role)

type 로 식별되는 선택 목록에 대한 항목 데이터를 반환합니다. role 매개변수는 요청할 데이터를 지정합니다. index 매개변수는 선택 목록 내의 0을 기준으로 한 인덱스입니다.

int selectionListItemCount(int type)

type 로 식별되는 선택 목록에 포함된 항목의 수를 반환합니다.

void selectionListItemSelected(int type, int index)

이 메서드는 사용자가 ` index `에 있는 항목을 선택했을 때 호출됩니다. 선택된 목록은 ` type ` 매개변수로 식별됩니다.

list<int> selectionLists()

이 입력 방식에 사용되는 선택 유형 목록을 반환합니다.

이 메서드는 입력 방식이 활성화될 때 및 입력 방식 힌트가 업데이트될 때마다 입력 엔진에 의해 호출됩니다. 입력 방식은 원하는 선택 목록 유형을 반환하여 선택 목록을 예약할 수 있습니다.

입력 방식은 ` selectionListsChanged()` 신호를 발생시켜 언제든지 입력 엔진에 선택 목록 업데이트를 요청할 수 있습니다. 이 신호는 이 메서드의 호출을 트리거하여, 입력 방식이 선택 목록 유형을 업데이트할 수 있게 합니다.

bool setInputMode(string locale, int inputMode)

이 입력 방식에 대해 inputMode 및 locale 를 변경합니다. 이 메서드는 성공하면 true 를 반환합니다.

bool setTextCase(int textCase)

이 입력 방식에 대한 ` textCase `를 업데이트합니다. 이 메서드는 성공 시 ` true `을 반환합니다.

text_case의 가능한 값은 다음과 같습니다:

• InputEngine.Lower 소문자 텍스트.
• InputEngine.Upper 대문자 텍스트.

[since QtQuick.VirtualKeyboard 2.0] Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)

이 메서드는 지정된 patternRecognitionMode 를 통해 트레이스 상호작용이 시작될 때 호출됩니다. 트레이스는 traceId 로 고유하게 식별됩니다. traceCaptureDeviceInfo 는 소스 장치에 대한 정보를 제공하며, traceScreenInfo 는 화면 컨텍스트에 대한 정보를 제공합니다.

입력 방식이 이벤트를 수락하고 트레이스 입력을 캡처하려는 경우, 새로운 Trace 객체를 반환해야 합니다. 이 객체는 InputMethod.traceEnd() 메서드가 호출될 때까지 유효한 상태를 유지해야 합니다. 트레이스가 화면에 렌더링된 경우, Trace 객체가 소멸될 때까지 화면에 남아 있습니다.

이 메서드는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.

[since QtQuick.VirtualKeyboard 2.0] bool traceEnd(Trace trace)

이 메서드는 트레이스 상호작용이 종료될 때 호출됩니다. 입력 방식은 이 함수가 호출된 후 어느 시점에서든 ` trace ` 객체를 해제해야 합니다. 성공 시 ` true `를 반환합니다.

수집된 데이터에 접근하는 방법은 ‘입력 방식용 추적 API’를 참조하십시오.

이 메서드는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.

void update()

이 메서드는 입력 방식이 업데이트되어야 할 때 입력 엔진에 의해 호출됩니다. 입력 방식은 현재의 편집 전 텍스트를 닫고 내부 상태를 기본값으로 복원해야 합니다.