Back to Qt.io
Contact Us Blog Download Qt
このページでは

KeyboardStyle QML Type

仮想キーボード用のスタイリングインターフェースを提供します。詳細...

Import Statement: import QtQuick.VirtualKeyboard.Styles
Inherits:

QtObject

プロパティ

詳細な説明

スタイルタイプは、InputPanel が仮想キーボードを装飾するために使用するスタイル定義を提供します。

デザインサイズは、仮想キーボードのアスペクト比を指定します。スタイルは、キーボードの実際の高さとデザインの高さから計算される「scaleHint 」に基づいてスケーリングされます。

キーボードは、keyboardDesignWidth およびkeyboardDesignHeight によって定義された固定のデザインサイズでレイアウトされ、その後、利用可能な幅に合わせてスケーリングされます。レンダリングされた高さは、デザインのアスペクト比（keyboardDesignHeight * width / keyboardDesignWidth ）に基づいて決定されます。keyboardHeight は、実行時に使用される実際のスケーリング後の高さを反映します。

keyboardDesignMaximumHeight オプションで、その高さを上限に制限することができます。上限が適用されていない場合、キー領域は利用可能な幅全体に広がります。スケーリング後の高さが最大値を超える場合、デザインのアスペクト比が維持され、代わりにキーボード全体がkeyboardDesignMaximumHeight / keyboardDesignHeight によってスケーリングされるため、キーボードの高さが最大値を超えることはありません。 この上限設定が適用された場合、キー領域は利用可能な幅よりも狭くなり、中央に配置されるため、両側に余白が生じます。キーボードの背景のみが引き続き全幅に広がります。scaleHint は、keyboardHeight とkeyboardDesignHeight の比率であり、すべてのピクセル寸法の比率を維持するために使用する必要があります。

なお、keyboardDesignWidth およびkeyboardDesignHeight はオーサリング単位（組み込みスタイルでは2560x800 が使用され、そのサイズでレンダリングされることはありません）であるのに対し、keyboardDesignMaximumHeight は論理ピクセル単位です。これは、レンダリングされた高さ（これも論理ピクセル単位）と直接比較されるためです。

プロパティのドキュメント

alternateKeysListBackground : Component

代替キー一覧の背景用テンプレート。

alternateKeysListBottomMargin : real

代替キー一覧パネルの下余白。

alternateKeysListDelegate : Component

代替キーのリスト項目のテンプレート。

注：この デリゲートは 、ListView 内で使用されます。

この項目では、以下のプロパティが利用可能です：

  • text キーのテキスト
  • data キーのデータ

alternateKeysListHighlight : Component

代替キー一覧のハイライト用テンプレート。

注： デリゲートは `ListView.highlight` として使用されます。

alternateKeysListItemHeight : real

代替キーの一覧項目の高さ。

alternateKeysListItemWidth : real

代替キーのリスト項目の幅。

alternateKeysListLeftMargin : real

代替キー一覧パネルの左余白。

alternateKeysListRightMargin : real

代替キー一覧パネルの右余白。

alternateKeysListTopMargin : real

代替キー一覧パネルの上部余白。

backspaceKeyPanel : Component

バックスペースキー用のテンプレート。

注: デリゲートは 、KeyPanel 型を基にしなければなりません。

characterPreviewDelegate : Component

キャラクタープレビューポップアップ用のテンプレート。

デリゲートにtext プロパティが含まれている場合、コンポーネントがアクティブになると、そのプロパティは表示テキストで更新されます。

property string text

例：

characterPreviewDelegate: Item {
    property string text
    id: characterPreview
    Rectangle {
        id: characterPreviewBackground
        anchors.fill: parent
        ...
        Text {
            text: characterPreview.text
            anchors.fill: parent
            ...
        }
    }
}

characterPreviewMargin : real

各キーの上端とcharacterPreviewDelegate の下端との間のピクセル数。

enterKeyPanel : Component

Enterキー用のテンプレート。

注： デリゲートは 、KeyPanel 型を基にする必要があります。

fullScreenInputBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

このプロパティは、フルスクリーン入力の背景に関するデリゲートを保持します。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.2 で導入されました。

fullScreenInputColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

このプロパティは、全画面表示の入力フィールドのテキストの色を指定します。

デフォルトの色は黒です。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.2 で導入されました。

fullScreenInputContainerBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

このプロパティは、フルスクリーン入力コンテナの背景に関するデリゲートを保持します。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.2 で導入されました。

fullScreenInputCursor : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

このプロパティは、フルスクリーン入力フィールドのカーソルに関するデリゲートを保持します。

このデリゲートは、フルスクリーン入力フィールドに対して定義されたparent.blinkStatus プロパティに従って、カーソルの表示/非表示を切り替える必要があります。例：

fullScreenInputCursor: Rectangle {
    width: 1
    color: "#000"
    visible: parent.blinkStatus
}

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.2 で導入されました。

fullScreenInputFont : font [since QtQuick.VirtualKeyboard.Styles 2.2]

このプロパティは、全画面入力フィールドのfont を保持します。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.2 で導入されました。

fullScreenInputMargins : real [since QtQuick.VirtualKeyboard.Styles 2.2]

このプロパティは、全画面入力フィールドの周囲の余白を指定します。

デフォルト値は0 です。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.2 で導入されました。

fullScreenInputPadding : real [since QtQuick.VirtualKeyboard.Styles 2.2]

このプロパティは、全画面表示された入力コンテンツの周囲のパディングを指定します。

デフォルト値は0 です。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.2 で導入されました。

fullScreenInputPasswordCharacter : string [since QtQuick.VirtualKeyboard.Styles 2.2]

このプロパティは、フルスクリーン入力フィールドのパスワードマスク文字を保持します。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.2 で導入されました。

fullScreenInputSelectedTextColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

このプロパティは、フルスクリーン入力フィールドで選択されたテキストの色を指定します。

デフォルトの色はfullScreenInputColor に設定されています。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.2 で導入されました。

fullScreenInputSelectionColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

このプロパティは、フルスクリーン入力フィールドの選択色を指定します。

デフォルトの色は半透明の黒です。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.2で導入されました。

functionPopupListBackground : Component [since 6.2]

関数のポップアップリストの背景用テンプレート。

このプロパティは Qt 6.2 で導入されました。

functionPopupListDelegate : Component [since 6.2]

関数リスト項目のテンプレート。

注：この デリゲートは 、ListView 内で使用されます。

この項目では、以下のプロパティを利用できます：

  • keyboardFunction - 現在の項目のキーボード機能。

このプロパティは Qt 6.2 で導入されました。

functionPopupListHighlight : Component [since 6.2]

関数ポップアップリストのハイライト用テンプレート。

注： デリゲートは `ListView.highlight` として使用されます。

このプロパティは Qt 6.2 で導入されました。

handwritingKeyPanel : Component

手書きモードキー用のテンプレート。

注: デリゲートは 、KeyPanel 型を基に作成する必要があります。

hideKeyPanel : Component

「hide」キー用のテンプレート。

注： デリゲートは 、KeyPanel 型を基にしなければなりません。

keyPanel : Component

通常のキー用のテンプレート。

注： デリゲートは 、KeyPanel 型を基にする必要があります。

例：

keyPanel: KeyPanel {
    Rectangle {
        anchors.fill: parent
        ...
        Text {
            anchors.fill: parent
            text: control.displayText
            ...
        }
    }
}

keyboardBackground : Component

キーボードの背景用テンプレート。

例：

keyboardBackground: Rectangle {
    color: "black"
}

keyboardDesignHeight : real

キーボードのデザイン高さ（オーサリング単位）。

keyboardDesignWidth と合わせて、キーボードレイアウトの設計アスペクト比を定義します。レンダリングされる高さはkeyboardDesignHeight * width / keyboardDesignWidth ですが、その値がkeyboardDesignMaximumHeight を超える場合は、設計アスペクト比が維持され、代わりにキーボード全体がkeyboardDesignMaximumHeight / keyboardDesignHeight 倍にスケーリングされます。また、これはscaleHint で使用される基準高さでもあります。

keyboardDesignMaximumHeight : real [since 6.11]

キーボードの最大設計高さ（論理ピクセル単位）。

0 より大きい値に設定すると、keyboardDesignHeight を利用可能な幅にスケーリングした際に生じるレンダリング高さが、この値で上限に制限されます。スケーリング後の高さがこの最大値を超える場合、キーボードはkeyboardDesignMaximumHeightでレンダリングされます。この際、デザインの縦横比は維持され、代わりにキーボード全体がkeyboardDesignMaximumHeight / keyboardDesignHeight でスケーリングされるため、キーボードの高さが最大値を超えることはありません。0 以下の値（デフォルト）は、最大値がないことを意味し、高さは幅に合わせてスケーリングされたkeyboardDesignHeight に従います。

keyboardDesignWidth やkeyboardDesignHeight とは異なり、この値は論理ピクセル単位です。これは、レンダリングされた高さと直接比較されるためです。

このプロパティは Qt 6.11 で導入されました。

keyboardDesignWidth : real

キーボードの設計幅（オーサリング単位）。

keyboardDesignHeight と合わせて、キーボードレイアウトの設計アスペクト比を定義します。スタイルはこのサイズで作成され、その後実際の幅に合わせて拡大縮小されます。レンダリングされる高さは、keyboardDesignHeight * width / keyboardDesignWidth から算出されます。

keyboardHeight : real

キーボードの現在の高さ（論理ピクセル単位）。

これは、キーボードがレンダリングされる際の実際のスケーリング後の高さです。これはキーボードの実装によって設定され（キー領域コンテナの高さに紐付けられています）、利用可能な幅に対してkeyboardDesignWidth 、keyboardDesignHeight 、および（設定されている場合は）keyboardDesignMaximumHeight を適用した結果得られるレイアウトを反映しています。keyboardDesignHeight と組み合わせて使用することで、scaleHint を取得できます。

keyboardRelativeBottomMargin : real

最下部のキーとキーボードコンテナの下端との間の距離。キーボードの高さに対する割合（0.0 -1.0 ）として表されます。

keyboardRelativeLeftMargin : real

キーボードの幅に対する、左端のキーとキーボードの左端との間の距離の割合（0.0 -1.0 ）。

keyboardRelativeRightMargin : real

キーボードの幅に対する、右端のキーとキーボードの右端との距離の割合（0.0 -1.0 ）。

この値は、キーボードの幅に比例します。

keyboardRelativeTopMargin : real

最上段のキーとキーボードの上端との間の距離を、キーボードの高さに対する割合（0.0 -1.0 ）として表したものです。

languageKeyPanel : Component

言語キーのテンプレート。

注： デリゲートは 、KeyPanel 型を基にしなければなりません。

languageListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

このプロパティは、言語リストビューに追加される項目に適用する遷移を保持します。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

languageListBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

言語リストの背景用テンプレート。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

languageListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

言語リスト項目のテンプレート。

注：この デリゲートは 、ListView で使用されます。

注: デリゲートは 、SelectionListItem 型を基にする必要があります。

この項目では、以下のプロパティを使用できます：

  • displayName 言語の表示名。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

languageListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

言語リストのハイライト用テンプレート。

注： デリゲートは `ListView.highlight` として使用されます。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

languageListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

このプロパティは、言語リストビューから削除される項目に適用される遷移を保持します。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

languagePopupListEnabled : bool [since QtQuick.VirtualKeyboard.Styles 2.1]

このプロパティは、言語キーをクリックした際にポップアップリストを表示するかどうかを決定します。このプロパティが「false 」に設定されている場合、言語キーをクリックすると、利用可能な言語が1つずつ順に切り替わります。

デフォルト値はfalse です。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

modeKeyPanel : Component

汎用モードキー用のテンプレート。

このテンプレートは、キーの状態が「オン」または「オフ」となる視覚化を提供します。このテンプレートは、ステータスにかかわらずキーのラベルが同じままである場合に使用されます。

現在の状態は、control.mode プロパティで取得できます。

注: デリゲートは 、KeyPanel 型を基に作成する必要があります。

ナビゲーションのフォーカス項目用のテンプレート。

この項目は、矢印キーによるナビゲーションモードにおいて、キーボード上のナビゲーションフォーカスを強調表示するために使用されます。

このアイテムは通常、コントラストの高い枠線を持つ透明な長方形です。

このプロパティは、QtQuick.VirtualKeyboard.Styles 1.1 で導入されました。

popupListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

このプロパティは、ポップアップリストビューに追加されるアイテムに適用するトランジションを保持します。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

popupListBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

ポップアップリストの背景用のテンプレート。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1で導入されました。

popupListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

ポップアップリスト項目のテンプレート。

注：この デリゲートは 、ListView で使用されます。

注： デリゲートは 、SelectionListItem 型を基にしなければなりません。

この項目では、以下のプロパティが利用可能です：

  • display 現在の項目の表示テキスト。
  • wordCompletionLength 表示テキストの末尾から計測した単語補完の長さ。
  • dictionary 単語の辞書タイプ。QVirtualKeyboardSelectionListModel::DictionaryType を参照してください。
  • canRemoveSuggestion その単語を辞書から削除できるかどうかを示すブール値。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

popupListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

ポップアップリストのハイライト用テンプレート。

注： デリゲートは `ListView.highlight` として使用されます。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

popupListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

このプロパティは、ポップアップリストビューから削除されるアイテムに適用される遷移を保持します。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

scaleHint : real [read-only]

キーボードスタイルのスケールヒント。この値は、keyboardHeight をkeyboardDesignHeight で割ることで算出されます。すべてのピクセル寸法は、この値に比例している必要があります。

selectionHandle : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

この項目は、テキスト選択範囲の境界を示すとともに、選択範囲の開始位置や終了位置をインタラクティブに移動するために使用されます。開始位置と終了位置の両方に同じ項目が使用されます。

選択ハンドルは現在、アプリケーションベースの統合方法でのみサポートされています。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

selectionListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 1.3]

このプロパティは、選択リストビューに追加される項目に適用する遷移を保持します。

このプロパティは、QtQuick.VirtualKeyboard.Styles 1.3 で導入されました。

selectionListBackground : Component

選考リストの背景用テンプレート。

selectionListDelegate : Component

選択リスト項目のテンプレート。

注：この デリゲートは 、ListView で使用されます。

注: デリゲートは 、SelectionListItem 型を基にする必要があります。

この項目では、以下のプロパティが利用可能です：

  • display 現在の項目の表示テキスト。
  • wordCompletionLength 表示テキストの末尾から測定した単語補完の長さ。
  • dictionary 単語の辞書タイプ。QVirtualKeyboardSelectionListModel::DictionaryType を参照してください。
  • canRemoveSuggestion その単語を辞書から削除できるかどうかを示すブール値。

selectionListHeight : real

選択リストの高さ。

selectionListHighlight : Component

選択リストのハイライト用テンプレート。

注： デリゲートは `ListView.highlight` として使用されます。

selectionListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 1.3]

このプロパティは、選択リストビューから削除される項目に適用する遷移を保持します。

このプロパティは、QtQuick.VirtualKeyboard.Styles 1.3 で導入されました。

shiftKeyPanel : Component

Shiftキー用のテンプレート。

注： デリゲートは 、KeyPanel 型を基にする必要があります。

spaceKeyPanel : Component

スペースキー用のテンプレート。

注： デリゲートは 、KeyPanel 型を基に定義する必要があります。

symbolKeyPanel : Component

シンボルモードキー用のテンプレート。

注： デリゲートは 、KeyPanel 型を基にしなければなりません。

traceCanvasDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Trace オブジェクトをレンダリングするためのテンプレート。

注： デリゲートは TraceCanvas 型を基にする必要があります。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

traceInputKeyPanelDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

トレース入力キーのテンプレート。

注： デリゲートは 、TraceInputKeyPanel 型を基に作成する必要があります。

このプロパティは、QtQuick.VirtualKeyboard.Styles 2.1 で導入されました。

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