이 페이지에서

InputContext QML Type (Singleton)

입력 컨텍스트에 대한 액세스를 제공합니다. 더 보기...

Import Statement: import QtQuick.VirtualKeyboard
In C++: QVirtualKeyboardInputContext

참고: 이 유형은 QML 싱글톤입니다. QML 엔진에는 이 유형의 인스턴스가 하나만 있습니다.

속성

방법

상세 설명

입력 컨텍스트는 싱글톤 인스턴스로 액세스할 수 있습니다.

프로퍼티 문서

anchorPosition : int [read-only, since QtQuick.VirtualKeyboard 2.2]

이 속성은 앵커 위치가 변경될 때 변경됩니다.

이 프로퍼티는 QtQuick.VirtualKeyboard 2.2에 도입되었습니다.

anchorRectIntersectsClipRect : bool [read-only]

선택 앵커의 경계 사각형이 노출된 입력 항목 사각형과 교차하는 경우 true 를 유지합니다.

Qt::ImAnchorRectangleQt::ImInputItemClipRectangle참조하세요 .

anchorRectangle : rect [read-only, since QtQuick.VirtualKeyboard 2.1]

이 속성은 앵커 사각형이 변경될 때 변경됩니다.

이 프로퍼티는 QtQuick.VirtualKeyboard 2.1에 도입되었습니다.

animating : bool

이 프로퍼티를 사용하여 UI 전환 상태 등의 애니메이션 상태를 설정할 수 있습니다.

capsLockActive : bool [read-only, since QtQuick.VirtualKeyboard 2.4]

이 속성은 캡 잠금 상태가 변경되면 변경됩니다.

이 프로퍼티는 QtQuick.VirtualKeyboard 2.4에 도입되었습니다.

cursorPosition : int [read-only]

이 속성은 커서 위치가 변경되면 변경됩니다.

cursorRectIntersectsClipRect : bool [read-only]

입력 커서의 경계 사각형이 노출된 입력 항목 사각형과 교차하는 경우 true 를 유지합니다.

Qt::ImCursorRectangleQt::ImInputItemClipRectangle참조하세요 .

cursorRectangle : rect [read-only]

이 속성은 커서 사각형이 변경될 때 변경됩니다.

inputEngine : InputEngine [read-only]

이 프로퍼티는 입력 엔진을 저장합니다.

inputMethodHints : int [read-only]

이 속성은 입력 방법 힌트가 변경될 때 변경됩니다.

keyboardObserver : KeyboardObserver [read-only, since 6.1]

키보드 변경 이벤트의 알림을 수신하는 데 사용할 수 있는 키보드 관찰자 객체를 보유합니다.

이 프로퍼티는 Qt 6.1에 도입되었습니다.

locale : string [read-only]

이 속성은 입력 로캘이 변경되면 변경됩니다.

preeditText : string

이 속성은 사전 편집 텍스트를 설정합니다.

selectedText : string [read-only]

이 속성은 선택한 텍스트가 변경되면 변경됩니다.

selectionControlVisible : bool [read-only]

선택 컨트롤이 현재 표시된 경우 true 을 누릅니다.

shiftActive : bool [read-only, since QtQuick.VirtualKeyboard 2.4]

이 속성은 교대근무 상태가 변경될 때 변경됩니다.

이 프로퍼티는 QtQuick.VirtualKeyboard 2.4에 도입되었습니다.

surroundingText : string [read-only]

이 속성은 커서 주변의 텍스트가 변경될 때 변경됩니다.

uppercase : bool [read-only, since QtQuick.VirtualKeyboard 2.2]

shiftActive 또는 capsLockActivetrue 일 때 이 속성은 true 입니다.

이 프로퍼티는 QtQuick.VirtualKeyboard 2.2에 도입되었습니다.

메서드 문서

void clear()

미리 편집한 텍스트를 지웁니다.

void commit()

현재 미리 편집한 텍스트를 커밋합니다.

void commit(string text, int replaceFrom = 0, int replaceLength = 0)

최종 text 을 입력 항목에 커밋하고 선택적으로 미리 편집한 텍스트의 시작 부분을 기준으로 텍스트를 수정합니다. replaceFrom이 0이 아닌 경우 textreplaceFrom에 상대적인 내용을 replaceLength의 길이로 바꿉니다.

void sendKeyClick(int key, string text, int modifiers = 0)

현재 포커스가 있는 입력 항목에 지정된 key, textmodifiers 으로 키 클릭 이벤트를 보냅니다.

© 2026 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.