このページでは

C

BaseKey QML Type

すべてのキー型に共通する親クラス。詳細...

Import Statement: import QtQuick.VirtualKeyboard.Components
Since: Qt Quick Ultralite 2.9
Inherits:

Item

Inherited By:
11 types

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

プロパティ

シグナル

詳細説明

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

この型は、レイアウト内で直接使用すべきではありません。代わりに、KeyやEnterKey などの専用のキー型を使用してください。

keyパネル要素がない場合、キーは表示されません。keyパネルのスタイル設定方法の詳細については、スタイリングのドキュメントを参照してください。

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

active : bool

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

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

alternativeKeys : string

文字列または文字列のリストを代替キーとして設定します。

値が文字列の場合、代替キーはその文字列の個々の文字として表示されます。値が文字列のリストの場合、そのリストが代わりに使用されます。

このプロパティが設定されている場合、キーを長押しした際にユーザーに表示される代替キーのビューがこれになります。

注: 代替キーに「text 」が含まれている場合 、そのキーはユーザーに表示される代替キーから除外され、その位置が代わりにハイライトされた項目のインジケータとして使用されます。

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

AlternativeKeysValue は、文字列または文字列のリストを受け入れる不透明な値型です。

displayAlternativeKeys : string

このプロパティを使用すると、「代替キー」ビューでユーザーに表示されるキー文字列のリストを上書きすることができます。入力メソッドに実際に送信されるのは、alternativeKeys 内の各インデックスにあるキーです。

このプロパティには、文字列またはキー文字列のリストを指定できます。

displayText : string

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

この文字列はキーボードレイアウトに表示されます。

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

functionKey : bool

ファンクションキーの属性を設定します。

デフォルト値は false です。

highlighted : bool

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

デフォルト値は false です。

key : int

入力方式の処理に使用するキーコードを設定します。

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

keyType : int

専用キーのキータイプ。取り得る値:

  • QtVirtualKeyboard.KeyType.BaseKey
  • QtVirtualKeyboard.KeyType.BackspaceKey
  • QtVirtualKeyboard.KeyType.ChangeLanguageKey
  • QtVirtualKeyboard.KeyType.EnterKey
  • QtVirtualKeyboard.KeyType.FillerKey
  • QtVirtualKeyboard.KeyType.HideKeyboardKey
  • QtVirtualKeyboard.KeyType.InputModeKey
  • QtVirtualKeyboard.KeyType.Key
  • QtVirtualKeyboard.KeyType.ModeKey
  • QtVirtualKeyboard.KeyType.ShiftKey
  • QtVirtualKeyboard.KeyType.SpaceKey
  • QtVirtualKeyboard.KeyType.SymbolModeKey

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

noKeyEvent : bool

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

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

noModifier : bool

送信されるキーのキー修飾子を無効にします。

デフォルト値は false です。

pressed : bool

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

キーが有効かつアクティブな状態である場合にのみ、押下状態は true になります。キーの状態が「押下」になると、入力エンジンに対してキーダウンイベントが発生します。キーが離されると、キーアップイベントが発生します。

repeat : bool

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

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

デフォルト値は false です。

注: 現在、この プロパティは効果を持ちません。

showPreview : bool

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

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

smallText : string

キーの隅に表示される小さなテキストを設定します。

代替キーのデフォルト項目に基づくデフォルト値。

smallTextVisible : bool

小文字の表示設定を指定します。

デフォルト値は、KeyboardLayout.smallTextVisible から継承されます。

text : string

入力方式の処理に使用するキーテキストを設定します。

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

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

uppercased : bool

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

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

weight : real

キーの相対的な大きさを決定するキーの重み値を設定します。

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

デフォルト値はKeyboardLayout.keyWeight

Signal ドキュメント

clicked()

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

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

特定の Qt ライセンスの下で利用可能です。
詳細はこちらをご覧ください。