InputMethod QML Type

QML에서 입력 메서드를 만들기 위한 기본 유형입니다. 더 보기...

Import Statement: import QtQuick.VirtualKeyboard

속성

신호

방법

상세 설명

InputMethod 유형을 사용하면 InputEngine 에 할당할 수 있는 사용자 지정 입력 메서드를 만들 수 있습니다.

속성 문서

inputContext : InputContext [read-only]

입력 컨텍스트입니다.


inputEngine : InputEngine [read-only]

입력 엔진입니다.


신호 문서

selectionListActiveItemChanged(int type, int index)

입력 메서드는 type 으로 식별되는 선택 목록에서 현재 index 가 변경되었을 때 이 신호를 내보냅니다.

참고: 해당 핸들러는 onSelectionListActiveItemChanged 입니다.


selectionListChanged(int type)

입력 메서드는 선택 목록의 내용이 변경될 때 이 신호를 전송합니다. type 매개변수는 변경된 선택 목록을 지정합니다.

참고: 해당 핸들러는 onSelectionListChanged 입니다.


[since QtQuick.VirtualKeyboard 2.2] selectionListsChanged()

입력 메서드는 선택 목록 유형이 변경되면 이 신호를 발산합니다. 이 신호는 selectionLists() 메서드 호출을 트리거하여 입력 메서드가 선택 목록 유형을 업데이트할 수 있도록 합니다.

참고: 해당 핸들러는 onSelectionListsChanged 입니다.

이 신호는 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에 도입되었습니다.


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)

이 입력 메서드에 대해 inputModelocale 을 변경합니다. 이 메서드는 성공하면 true 을 반환합니다.


bool setTextCase(int textCase)

이 입력 메서드에 대해 textCase 을 업데이트합니다. 성공하면 true 을 반환합니다.

텍스트 대소문자의 가능한 값은 다음과 같습니다:

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

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

이 메서드는 지정된 patternRecognitionMode 으로 추적 상호 작용이 시작될 때 호출됩니다. 추적은 traceId 에 의해 고유하게 식별됩니다. traceCaptureDeviceInfo 은 소스 디바이스에 대한 정보를 제공하고 traceScreenInfo 은 화면 컨텍스트에 대한 정보를 제공합니다.

입력 메서드가 이벤트를 수락하고 추적 입력을 캡처하려는 경우 새 추적 객체를 반환해야 합니다. 이 객체는 InputMethod.traceEnd() 메서드가 호출될 때까지 유효해야 합니다. 트레이스가 화면에 렌더링되면 트레이스 객체가 소멸될 때까지 그 상태로 유지됩니다.

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


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

이 메서드는 추적 상호 작용이 종료될 때 호출됩니다. 입력 메서드는 이 함수가 호출된 후 어느 시점에 trace 객체를 소멸해야 합니다. 성공하면 true 을 반환합니다.

수집된 데이터에 액세스하는 방법은 입력 메서드용 추적 API를 참조하세요.

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


update()

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


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.