BaseKey QML Type
すべてのキータイプに共通の親。詳細...
| Import Statement: | import QtQuick.VirtualKeyboard.Components |
| Inherits: | |
| Inherited By: | BackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, HideKeyboardKey, Key, and ShiftKey |
プロパティ
- active : bool
- alternativeKeys : var
- displayAlternativeKeys : var
(since QtQuick.VirtualKeyboard 6.2) - displayText : string
- effectiveAlternativeKeys : var
(since QtQuick.VirtualKeyboard 2.0) - effectiveAlternativeKeysHighlightIndex : int
(since QtQuick.VirtualKeyboard 2.0) - functionKey : bool
- highlighted : bool
- key : int
- keyPanelDelegate : alias
- keyType : int
(since QtQuick.VirtualKeyboard 6.1) - noKeyEvent : bool
(since QtQuick.VirtualKeyboard 1.3) - noModifier : bool
(since QtQuick.VirtualKeyboard 1.3) - pressed : bool
- repeat : bool
- showPreview : bool
- smallText : string
(since QtQuick.VirtualKeyboard 2.0) - smallTextVisible : bool
(since QtQuick.VirtualKeyboard 2.0) - soundEffect : url
(since QtQuick.VirtualKeyboard 1.1) - text : string
- uppercased : bool
- weight : real
信号
- clicked()
詳細説明
BaseKeyはキーボードレイアウトのすべてのキーに共通する型である。
このタイプはレイアウトで直接使うべきではありません。代わりにKeyやEnterKey のような特殊なキー型を使用する必要があります。
プロパティ Documentation
active : bool |
このプロパティは、キーのアクティブ状態を保持します。
このプロパティは、キーが押されると自動的にtrueに設定されます。
alternativeKeys : var |
代替キーのリストを設定します。
このプロパティには文字列、または文字列のリストを設定することができる。値が文字列の場合、代替キーはその文字列の個々の文字として表示されます。値が文字列のリストの場合、リストが代わりに使用されます。
代替キーは、このプロパティが設定されたキーを押し続けることでユーザーに提示される。
注意： 代替キーにキーtext が含まれる場合、それはeffectiveAlternativeKeys からフィルタリングされ、代わりにその位置がハイライトされた項目のインジケータとして使用されます。
デフォルトは空リストです。
displayAlternativeKeys : var |
このプロパティは、代替キービューでユーザーに表示されるキー文字列のリストを上書きすることができます。
このプロパティは、QtQuick.VirtualKeyboard 6.2 で導入されました。
displayText : string |
表示テキストを設定します。
この文字列はキーボードレイアウトでレンダリングされます。
デフォルト値はキーテキストです。
effectiveAlternativeKeys : var |
このプロパティには、ユーザーに提示される有効な代替キーが含まれます。
リストには、text 項目を除くalternativeKeys の項目が含まれます。
このプロパティは、QtQuick.VirtualKeyboard 2.0 で導入されました。
effectiveAlternativeKeysHighlightIndex : int |
このプロパティには、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 |
Key 特殊化されたキーのタイプ。指定可能な値は { }{キータイプ列挙} で定義されています。QtVirtualKeyboard::KeyType
例えば、SpaceKey は、この値をQtVirtualKeyboard.KeyType.SpaceKey に設定します。
このプロパティは、QtQuick.VirtualKeyboard 6.1 で導入されました。
noKeyEvent : bool |
このプロパティは、入力メソッド処理のためにキーがキーイベントを発するかどうかを制御します。true の場合、キーイベントは無効になります。
デフォルトでは、キーが不明でない場合、またはテキストが空でない場合にキーイベントが発生します。
このプロパティは QtQuick.VirtualKeyboard 1.3 で導入されました。
noModifier : bool |
キー修飾子を無効にします。
デフォルトは false です。
このプロパティは QtQuick.VirtualKeyboard 1.3 で導入されました。
pressed : bool |
このプロパティは、キーの押された状態を保持します。
押された状態は、キーが有効でアクティブな場合にのみ真になります。キーの状態が押された状態になると、入力エンジンのキーダウンイベントがトリガーされます。キーが離されると、キーアップイベントがトリガーされます。
repeat : bool |
キーリピート属性を設定します。
リピートが有効な場合、キーは押されたまま入力イベントを繰り返します。alternativeKeys も設定されている場合は、repeat を使用しないでください。
デフォルトはfalseです。
showPreview : bool |
show preview属性を設定します。
デフォルトでは、ファンクションキーの文字プレビューポップアップは表示されません。
smallText : string |
キーの隅にレンダリングされる小さなテキストを設定します。
デフォルト値は、有効な代替キーのデフォルト項目に基づいています。
このプロパティは QtQuick.VirtualKeyboard 2.0 で導入されました。
smallTextVisible : bool |
小さいテキストの可視性を設定します。
デフォルト値は親から継承されます。
このプロパティは QtQuick.VirtualKeyboard 2.0 で導入されました。
soundEffect : url |
このプロパティは、キー押下時に再生する効果音を保持します。
効果音はキーボードスタイルで定義されるため、このプロパティは読み取り専用です。
このプロパティは QtQuick.VirtualKeyboard 1.1 で導入されました。
text : string |
入力メソッド処理用のキーテキストを設定します。
ほとんどの場合、これはキーコードのUnicode表現です。
デフォルト値は空文字列です。
uppercased : bool |
このプロパティは、キーの大文字と小文字の状態を保持します。
デフォルトでは、このプロパティはキーボードの大文字の状態を反映します。
weight : real |
キーの相対的な大きさを決定するキーウェイト値を設定します。
レイアウトのキー・サイズを変更するには、このプロパティを使用します。
デフォルト値は、レイアウト階層内のキーの親要素から継承されます。
シグナル・ドキュメント
clicked() |
このシグナルは、キーが押されたときにトリガーされ、キーのカスタム処理を可能にします。
注意： 対応するハンドラはonClicked です。
© 2025 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.
