이 페이지에서

HandwritingInputPanel QML Type

가상 키보드 UI용 필기 패널 애드온을 제공합니다. 더 보기...

Import Statement: import QtQuick.VirtualKeyboard
Since: QtQuick.VirtualKeyboard 2.0
Inherits:

Item

속성

상세 설명

HandwritingInputPanel은 InputPanel 을 위한 추가 구성 요소로, 애플리케이션에서 전체 화면 필기 입력을 가능하게 합니다.

HandwritingInputPanel은 InputPanel 과 나란히 전체 화면으로 고정되도록 설계되었습니다. 작동 원리는 필기 패널이 “사용 가능한” 상태일 때 InputPanel 이 보이지 않는 방식입니다. 이 기능은 내장되어 있으며, InputPanel 인스턴스에 대한 참조만 있으면 됩니다.

이 패널은 available 속성을 true 로 설정하여 작동시킵니다. 패널이 작동 중일 때 입력 포커스가 설정되면 키보드는 숨겨진 상태로 유지됩니다. available 가 true 상태일 때, active 속성을 true 로 설정하여 필기 입력을 활성화합니다.

필기 모드와 키보드 표시 여부를 제어하는 사용자 인터페이스는 애플리케이션에 따라 다릅니다. 권장되는 구현 방법 중 하나는 필기 패널에 플로팅 버튼을 사용하는 것으로, 한 번 클릭하면 필기 모드가 전환되고( active 속성 변경), 두 번 클릭하면 키보드 표시 여부가 전환됩니다( available 속성 변경).

또한 HandwritingInputPanel은 필기 입력 방식에 의해 생성된 제안 목록에서 사용자가 대체 단어 후보를 선택할 수 있도록 하는 단어 후보 팝업을 제공합니다.

속성 설명서

active : bool

이 속성은 필기 입력 방식의 활성화 상태를 제어합니다.

이 속성을 ` true `로 설정하면 필기 입력 방식이 활성화됩니다. 필기 입력 방식이 활성화된 상태에서는 모든 터치 입력이 필기 입력 패널에 포착되어 처리를 위해 입력 엔진으로 전달됩니다.

available : bool

이 속성은 필기 입력 방식의 사용 가능 여부를 제어합니다.

이 속성을 ` true `로 설정하면 필기 입력 방식이 준비되고 키보드 표시가 비활성화됩니다.

inputPanel : var

입력 패널 인스턴스에 대한 참조입니다.

이 속성은 기존 입력 패널 인스턴스로 설정되어야 합니다.

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