QVirtualKeyboardAbstractInputMethod Class

멤버 함수 문서

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

parent 로 입력 메서드를 구성합니다.

[virtual noexcept] QVirtualKeyboardAbstractInputMethod::~QVirtualKeyboardAbstractInputMethod()

입력 메소드를 파괴하고 할당된 모든 리소스를 해제합니다.

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

입력 모드를 지웁니다.

이 입력 방법이 다른 입력 방법으로 대체될 때 가상 키보드에서 이 메서드를 호출합니다. 예를 들어 가상 키보드에서 신호 처리기의 연결을 끊거나 리소스를 확보하기 위해 setInputMode() 메서드가 수행한 작업을 지워야 합니다.

입력 모드는 setInputMode()를 호출하여 다시 활성화할 수 있습니다. 그러나 setInputMethod() 및 clearInputMethod() 호출은 균형을 이루지 못한다는 점에 유의하세요. 따라서 예를 들어 clearInputMethod()에 대한 호출과 일치하는 호출 없이 setInputMethod()를 여러 번 호출할 수 있습니다.

기본 구현은 아무 일도 하지 않습니다.

이 함수는 QtQuick.VirtualKeyboard 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()

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