QVirtualKeyboardAbstractInputMethod Class

멤버 함수 문서

[explicit] QVirtualKeyboardAbstractInputMethod::QVirtualKeyboardAbstractInputMethod(QObject *parent = nullptr)

parent 를 사용하여 입력 방법을 생성합니다.

[virtual noexcept] QVirtualKeyboardAbstractInputMethod::~QVirtualKeyboardAbstractInputMethod()

입력 방식을 제거하고 할당된 모든 리소스를 해제합니다.

[virtual slot, since 6.1] void QVirtualKeyboardAbstractInputMethod::clearInputMode()

입력 모드를 해제합니다.

이 메서드는 현재 입력 방식이 다른 입력 방식으로 대체될 때 가상 키보드에 의해 호출됩니다. 이 메서드는 setInputMode() 메서드에 의해 수행된 작업을 초기화해야 합니다. 예를 들어, 가상 키보드에서 신호 핸들러를 분리하거나 리소스를 해제하는 등의 작업을 수행해야 합니다.

setInputMode()를 호출하여 입력 모드를 다시 활성화할 수 있습니다. 그러나 setInputMethod()와 clearInputMethod()의 호출 횟수가 반드시 일치하지는 않는다는 점에 유의해야 합니다. 예를 들어, clearInputMethod() 호출과 대응되지 않는 setInputMethod() 호출이 여러 번 발생할 수 있습니다.

기본 구현은 아무 작업도 수행하지 않습니다.

이 함수는 Qt 6.1에서 도입되었습니다.

[virtual, since QtQuick.VirtualKeyboard 2.4] bool QVirtualKeyboardAbstractInputMethod::clickPreeditText(int cursorPosition)

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

이 함수는 이벤트를 처리하는 경우 true 를 반환해야 합니다. 그렇지 않으면 입력은 추가 처리를 위해 reselect()로 넘어갑니다.

이 함수는 QtQuick.VirtualKeyboard 2.4에서 도입되었습니다.

QVirtualKeyboardInputContext *QVirtualKeyboardAbstractInputMethod::inputContext() const

입력 방식과 연결된 입력 컨텍스트를 반환합니다. 이 메서드는 입력 방식이 활성화되어 있지 않은 경우 ` NULL `를 반환합니다.

QVirtualKeyboardInputEngine *QVirtualKeyboardAbstractInputMethod::inputEngine() const

입력 방식과 연결된 입력 엔진을 반환합니다. 이 메서드는 입력 방식이 활성화되어 있지 않은 경우 ` NULL `를 반환합니다.

[pure virtual] QList<QVirtualKeyboardInputEngine::InputMode> QVirtualKeyboardAbstractInputMethod::inputModes(const QString &locale)

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

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

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

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

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

[virtual, since QtQuick.VirtualKeyboard 2.0] QList<QVirtualKeyboardInputEngine::PatternRecognitionMode> QVirtualKeyboardAbstractInputMethod::patternRecognitionModes() const

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

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

이 함수는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.

[virtual, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardAbstractInputMethod::reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)

이 함수는 cursorPosition 에 위치한 단어를 다시 선택하려고 시도합니다. reselectFlags 는 커서 위치와 관련하여 단어를 어떻게 선택해야 하는지에 대한 규칙을 정의합니다.

단어가 성공적으로 다시 선택된 경우, 이 함수는 true 를 반환합니다.

이 함수는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.

[virtual slot] void QVirtualKeyboardAbstractInputMethod::reset()

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

[signal] void QVirtualKeyboardAbstractInputMethod::selectionListActiveItemChanged(QVirtualKeyboardSelectionListModel::Type type, int index)

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

[signal] void QVirtualKeyboardAbstractInputMethod::selectionListChanged(QVirtualKeyboardSelectionListModel::Type type)

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

[virtual] QVariant QVirtualKeyboardAbstractInputMethod::selectionListData(QVirtualKeyboardSelectionListModel::Type type, int index, QVirtualKeyboardSelectionListModel::Role role)

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

[virtual] int QVirtualKeyboardAbstractInputMethod::selectionListItemCount(QVirtualKeyboardSelectionListModel::Type type)

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

[virtual] void QVirtualKeyboardAbstractInputMethod::selectionListItemSelected(QVirtualKeyboardSelectionListModel::Type type, int index)

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

[virtual] bool QVirtualKeyboardAbstractInputMethod::selectionListRemoveItem(QVirtualKeyboardSelectionListModel::Type type, int index)

이 메서드는 index 에 있는 항목을 사전에서 제거해야 할 때 호출됩니다. 선택 목록은 type 매개변수로 지정됩니다. 단어가 성공적으로 제거되면 이 함수는 true 를 반환합니다.

[virtual] QList<QVirtualKeyboardSelectionListModel::Type> QVirtualKeyboardAbstractInputMethod::selectionLists()

이 입력 방식에서 사용하는 선택 목록의 목록을 반환합니다.

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

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

[signal, since QtQuick.VirtualKeyboard 2.2] void QVirtualKeyboardAbstractInputMethod::selectionListsChanged()

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

이 함수는 QtQuick.VirtualKeyboard 2.2에서 도입되었습니다.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::setInputMode(const QString &locale, QVirtualKeyboardInputEngine::InputMode inputMode)

이 입력 방식에 대해 inputMode 및 locale 를 설정합니다. 성공하면 true 를 반환합니다.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::setTextCase(QVirtualKeyboardInputEngine::TextCase textCase)

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

[virtual, since QtQuick.VirtualKeyboard 2.0] QVirtualKeyboardTrace *QVirtualKeyboardAbstractInputMethod::traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)

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

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

이 함수는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.

[virtual, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardAbstractInputMethod::traceEnd(QVirtualKeyboardTrace *trace)

이 메서드는 추적 상호작용이 종료될 때 호출됩니다. 입력 메서드는 이 함수가 호출된 후 어느 시점에서든 ` trace ` 객체를 소멸시켜야 합니다. 수집된 데이터에 접근하는 방법은 ‘입력 메서드를 위한 추적 API’를 참조하십시오.

추적 상호작용이 수락된 경우, 이 메서드는 ` true `를 반환합니다.

이 함수는 QtQuick.VirtualKeyboard 2.0에서 도입되었습니다.

[virtual slot] void QVirtualKeyboardAbstractInputMethod::update()

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