BaseKey QML Type

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

Import Statement: import QtQuick.VirtualKeyboard.Components
Inherits:

Item

Inherited By:

BackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, HideKeyboardKey, Key, and ShiftKey

プロパティ

シグナル

詳細説明

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

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

プロパティ Documentation

active : bool

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

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


alternativeKeys : var

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

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

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

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

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


displayAlternativeKeys : var [since QtQuick.VirtualKeyboard 6.2]

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

このプロパティは、QtQuick.VirtualKeyboard 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 QtQuick.VirtualKeyboard 6.1]

Key 特殊化されたキーのタイプ。指定可能な値は { }{キータイプ列挙} で定義されます。QtVirtualKeyboard::KeyType

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

このプロパティは、QtQuick.VirtualKeyboard 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

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

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

デフォルトはfalseです。


showPreview : bool

show preview属性を設定します。

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


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

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

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

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


シグナル・ドキュメント

clicked()

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

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


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。