QVirtualKeyboardInputContext Class
입력 컨텍스트에 대한 액세스를 제공합니다. 더 보기...
| 헤더: | #include <QVirtualKeyboardInputContext> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake: | QT += virtualkeyboard |
| QML에서: | InputContext |
| 상속합니다: | QObject |
속성
|
|
공공 기능
| int | anchorPosition() const |
| bool | anchorRectIntersectsClipRect() const |
| QRectF | anchorRectangle() const |
| void | clear() |
| void | commit() |
| void | commit(const QString &text, int replaceFrom = 0, int replaceLength = 0) |
| int | cursorPosition() const |
| bool | cursorRectIntersectsClipRect() const |
| QRectF | cursorRectangle() const |
| QVirtualKeyboardInputEngine * | inputEngine() const |
| Qt::InputMethodHints | inputMethodHints() const |
| bool | isAnimating() const |
| bool | isCapsLockActive() const |
| bool | isSelectionControlVisible() const |
| bool | isShiftActive() const |
| bool | isUppercase() const |
| QVirtualKeyboardObserver * | keyboardObserver() const |
| QString | locale() const |
| QString | preeditText() const |
| QString | selectedText() const |
| void | sendKeyClick(int key, const QString &text, int modifiers = 0) |
| void | setAnimating(bool isAnimating) |
| void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0) |
| QString | surroundingText() const |
신호
| void | anchorPositionChanged() |
| void | anchorRectIntersectsClipRectChanged() |
| void | anchorRectangleChanged() |
| void | animatingChanged() |
| void | capsLockActiveChanged() |
| void | cursorPositionChanged() |
| void | cursorRectIntersectsClipRectChanged() |
| void | cursorRectangleChanged() |
| void | inputMethodHintsChanged() |
| void | localeChanged() |
| void | preeditTextChanged() |
| void | selectedTextChanged() |
| void | selectionControlVisibleChanged() |
| void | shiftActiveChanged() |
| void | surroundingTextChanged() |
| void | uppercaseChanged() |
속성 문서
[read-only] anchorPosition : const int
이 속성은 앵커 위치를 유지합니다.
이 속성은 앵커 위치가 변경되면 변경됩니다.
함수에 액세스합니다:
| int | anchorPosition() const |
알림 신호:
| void | anchorPositionChanged() |
[read-only] anchorRectIntersectsClipRect : const bool
선택 앵커의 경계 사각형이 노출된 입력 항목 사각형과 교차하는 경우 true 을 유지합니다.
기능에 액세스합니다:
| bool | anchorRectIntersectsClipRect() const |
알림 신호:
| void | anchorRectIntersectsClipRectChanged() |
Qt::ImAnchorRectangle 및 Qt::ImInputItemClipRectangle 을참조하세요 .
[read-only] anchorRectangle : const QRectF
이 속성은 앵커 직사각형을 보유합니다.
이 속성은 앵커 사각형이 변경되면 변경됩니다.
함수에 액세스합니다:
| QRectF | anchorRectangle() const |
알림 신호:
| void | anchorRectangleChanged() |
animating : bool
이 프로퍼티에는 애니메이션 상태가 저장됩니다.
이 속성을 사용하여 UI 전환 상태 등의 애니메이션 상태를 설정할 수 있습니다.
함수에 액세스합니다:
| bool | isAnimating() const |
| void | setAnimating(bool isAnimating) |
알림 신호:
| void | animatingChanged() |
[read-only] capsLockActive : const bool
이 속성은 대문자 잠금 상태를 유지합니다.
이 속성은 대문자 잠금 상태가 변경되면 변경됩니다.
액세스 함수:
| bool | isCapsLockActive() const |
알림 신호:
| void | capsLockActiveChanged() |
[read-only] cursorPosition : const int
이 속성은 커서 위치를 유지합니다.
이 속성은 커서 위치가 변경되면 변경됩니다.
함수에 액세스합니다:
| int | cursorPosition() const |
알림 신호:
| void | cursorPositionChanged() |
[read-only] cursorRectIntersectsClipRect : const bool
입력 커서의 경계 사각형이 노출된 입력 항목 사각형과 교차하는 경우 true 을 유지합니다.
기능에 액세스합니다:
| bool | cursorRectIntersectsClipRect() const |
알림 신호:
| void | cursorRectIntersectsClipRectChanged() |
Qt::ImCursorRectangle 및 Qt::ImInputItemClipRectangle 을참조하세요 .
[read-only] cursorRectangle : const QRectF
이 속성은 커서 직사각형을 유지합니다.
이 속성은 커서 사각형이 변경되면 변경됩니다.
함수에 액세스합니다:
| QRectF | cursorRectangle() const |
알림 신호:
| void | cursorRectangleChanged() |
[read-only] inputEngine : QVirtualKeyboardInputEngine* const
이 프로퍼티에는 입력 엔진이 저장됩니다.
이 프로퍼티는 입력 엔진을 저장합니다.
액세스 함수:
| QVirtualKeyboardInputEngine * | inputEngine() const |
[read-only] inputMethodHints : const Qt::InputMethodHints
이 속성은 입력 방법 힌트를 저장합니다.
이 속성은 입력 메서드 힌트가 변경되면 변경됩니다.
함수에 액세스합니다:
| Qt::InputMethodHints | inputMethodHints() const |
알림 신호:
| void | inputMethodHintsChanged() |
[read-only, since QtQuick.VirtualKeyboard 6.1] keyboardObserver : QVirtualKeyboardObserver* const
키보드 변경 이벤트의 알림을 수신하는 데 사용할 수 있는 키보드 관찰자 객체를 보유합니다.
이 프로퍼티는 QtQuick.VirtualKeyboard 6.1에 도입되었습니다.
액세스 함수:
| QVirtualKeyboardObserver * | keyboardObserver() const |
[read-only] locale : const QString
이 속성은 로캘을 저장합니다.
이 속성은 입력 로캘이 변경되면 변경됩니다.
함수에 액세스합니다:
| QString | locale() const |
알림 신호:
| void | localeChanged() |
preeditText : QString
이 속성에는 사전 편집 텍스트가 저장됩니다.
이 속성은 사전 편집 텍스트를 설정합니다.
함수에 액세스합니다:
| QString | preeditText() const |
| void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0) |
알림 신호:
| void | preeditTextChanged() |
[read-only] selectedText : const QString
이 속성은 선택한 텍스트를 저장합니다.
이 속성은 선택한 텍스트가 변경되면 변경됩니다.
기능에 액세스합니다:
| QString | selectedText() const |
알림 신호:
| void | selectedTextChanged() |
[read-only] selectionControlVisible : const bool
선택 컨트롤이 현재 표시된 경우 true 을 누릅니다.
기능에 접근합니다:
| bool | isSelectionControlVisible() const |
알림 신호:
| void | selectionControlVisibleChanged() |
[read-only] shiftActive : const bool
이 속성은 교대근무 상태를 저장합니다.
이 속성은 교대근무 상태가 변경되면 변경됩니다.
함수 액세스:
| bool | isShiftActive() const |
알림 신호:
| void | shiftActiveChanged() |
[read-only] surroundingText : const QString
이 속성은 커서 주변의 텍스트를 유지합니다.
이 속성은 커서 주변의 텍스트가 변경될 때 변경됩니다.
함수에 액세스합니다:
| QString | surroundingText() const |
알림 신호:
| void | surroundingTextChanged() |
[read-only] uppercase : const bool
이 속성은 대문자 상태를 유지합니다.
shiftActive 또는 capsLockActive 이 true 일 경우 이 속성은 true 입니다.
액세스 함수:
| bool | isUppercase() const |
알림 신호:
| void | uppercaseChanged() |
멤버 함수 문서
[invokable] void QVirtualKeyboardInputContext::clear()
미리 편집한 텍스트를 지웁니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] void QVirtualKeyboardInputContext::commit()
현재 미리 편집한 텍스트를 커밋합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)
최종 text 을 입력 항목에 커밋하고 선택적으로 미리 편집한 텍스트의 시작 부분을 기준으로 텍스트를 수정합니다. replaceFrom 이 0이 아닌 경우 text 은 replaceFrom 을 기준으로 한 내용을 replaceLength 의 길이로 바꿉니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] void QVirtualKeyboardInputContext::sendKeyClick(int key, const QString &text, int modifiers = 0)
현재 포커스가 있는 입력 항목에 지정된 key, text 및 modifiers 으로 키 클릭 이벤트를 보냅니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
© 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.
