このページでは

BaseKey QML Type

すべてのキータイプに共通の親。詳細...

Import Statement: import QtQuick.VirtualKeyboard.Components
Inherits:

Item

Inherited By:
14 types

BackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, FlickKey, HandwritingModeKey, HideKeyboardKey, InputModeKey, Key, ModeKey, NumberKey, ShiftKey, SpaceKey, and SymbolModeKey

プロパティ

信号

詳細説明

BaseKeyはキーボードレイアウトのすべてのキーに共通する型である。

このタイプはレイアウトで直接使うべきではありません。代わりにKeyやEnterKey のような特殊なキー型を使用する必要があります。

プロパティの説明

active : bool

このプロパティは、キーのアクティブ状態を保持する。

このプロパティは、キーが押されると自動的にtrueに設定されます。

alternativeKeys : var

代替キーのリストを設定する。

このプロパティには文字列、または文字列のリストを設定することができます。値が文字列の場合、代替キーはその文字列の個々の文字として表示されます。値が文字列のリストの場合、リストが代わりに使用されます。

代替キーは、このプロパティが設定されたキーを押し続けることでユーザーに提示される。

注意: 代替キーにキーtext が含まれる場合、それはeffectiveAlternativeKeys からフィルタリングされ、代わりにその位置がハイライトされた項目のインジケータとして使用されます。

デフォルトは空リストです。

displayAlternativeKeys : var [since 6.2]

このプロパティは、代替キービューでユーザーに表示されるキー文字列のリストを上書きすることができます。

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

displayText : string

表示テキストを設定します。

この文字列はキーボードレイアウトでレンダリングされます。

デフォルト値はキーテキストです。

effectiveAlternativeKeys : var [read-only, since QtQuick.VirtualKeyboard 2.0]

このプロパティには、ユーザに提示される有効な代替キーが含まれる。

リストには、text の項目を除くalternativeKeys の項目が含まれます。

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

effectiveAlternativeKeysHighlightIndex : int [read-only, since QtQuick.VirtualKeyboard 2.0]

このプロパティは、effectiveAlternativeKeys におけるハイライトされた項目のインデックスを含む。

このインデックスはalternativeKeys のキーtext のインデックスから計算される。

例えば、代替キーが "çcčć "を含み、キーtext が "c" である場合、このインデックスは 1 となり、ユーザーに提示される有効な代替キーは "ç[acceptional]čć "となります。

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

functionKey : bool

ファンクション・キー属性を設定する。

デフォルトはfalse。

highlighted : bool

キーのハイライト状態を設定する。

デフォルトはfalse。

key : int

入力メソッド処理用のキーコードを設定します。

デフォルトはQt.Key_unknownです。

keyPanelDelegate : alias

キーのキーパネル・デリゲートを設定します。

このプロパティは、キーの装飾に不可欠です。キー・パネル委譲がなければ、キーは不可視です。このプロパティは、継承されたキー・タイプに割り当てる必要があります。

keyType : int [since 6.1]

Key 特殊化されたキーの型。指定できる値は {QtVirtualKeyboard::KeyType}{key type enumeration} で定義されています。

例えば、SpaceKey は、この値をQtVirtualKeyboard.KeyType.SpaceKey に設定します。

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

noKeyEvent : bool [since QtQuick.VirtualKeyboard 1.3]

このプロパティは、キーが入力メソッド処理のためにキーイベントを発するかどうかを制御する。true の場合、キー・イベントは無効になります。

デフォルトでは、キーが不明でない場合、またはテキストが空でない場合にキーイベントが発生します。

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

noModifier : bool [since QtQuick.VirtualKeyboard 1.3]

放出されたキーのキー修飾子を無効にする。

デフォルトは false です。

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

pressed : bool

このプロパティは、キーの押された状態を保持する。

押された状態は、キーが有効でアクティブな場合にのみ真になります。キーの状態が押された状態になると、入力エンジンのキーダウンイベントがトリガーされます。キーが離されると、キーアップイベントがトリガーされます。

repeat : bool

キーリピート属性を設定する。

repeatが有効な場合、キーは押し続けている間、入力イベントを繰り返す。alternativeKeys も設定されている場合は、repeatを使用しないでください。

デフォルトはfalseです。

showPreview : bool

プレビュー表示属性を設定します。

デフォルトでは、ファンクションキーの文字プレビューポップアップは表示されません。

smallText : string [since QtQuick.VirtualKeyboard 2.0]

キーの隅にレンダリングされる小さなテキストを設定する。

デフォルト値は、有効な代替キーのデフォルト項目に基づいています。

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

smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]

小さなテキストの可視性を設定します。

デフォルト値は親から継承されます。

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

soundEffect : url [read-only, since QtQuick.VirtualKeyboard 1.1]

このプロパティは、キー押下時に再生される効果音を保持する。

効果音はキーボードスタイルで定義されるため、このプロパティは読み取り専用です。

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

text : string

入力メソッド処理用のキーテキストを設定します。

ほとんどの場合、これはキーコードの Unicode 表現です。

デフォルト値は空文字列です。

uppercased : bool

このプロパティは、キーの大文字小文字の状態を保持する。

デフォルトでは、このプロパティはキーボードの大文字の状態を反映します。

weight : real

キーの相対的なサイズを決定するキーのウェイト値を設定します。

このプロパティを使用して、レイアウト内のキーのサイズを変更します。

デフォルト値は、レイアウト階層内のキーの親要素から継承されます。

Signal ドキュメント

clicked()

このシグナルはキーが押されたときにトリガーされ、キーのカスタム処理が可能になる。

注意: 対応するハンドラはonClicked です。

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