HandwritingInputPanel QML Type
仮想キーボードUI用の手書きパネルアドオンを提供します。詳細...
| Import Statement: | import QtQuick.VirtualKeyboard |
| Since: | QtQuick.VirtualKeyboard 2.0 |
| Inherits: |
プロパティ
- active : bool
- available : bool
- inputPanel : var
詳細説明
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.