Back to Qt.io
Contact Us Blog Download Qt

Shortcut QML Type

キーボードショートカットを提供します。詳細...

Import Statement: import QtQuick

プロパティ

シグナル

詳細説明

Shortcutタイプは、キーボードショートカットを扱うことができます。ショートカットは、standard keyboard shortcuts のいずれかに設定するか、activate に必要な最大 4 つのキー押下シーケンスを含む文字列で記述することができます。

Item {
    id: view

    property int currentIndex

    Shortcut {
        sequences: [StandardKey.NextChild]
        onActivated: view.currentIndex++
    }
}

また、複数のショートカットsequences を設定することも可能で、複数の異なるキー押下シーケンスでショートカットをactivated することができます。

Keys およびshortcutOverride()も参照のこと 。

プロパティ Documentation

autoRepeat : bool

このプロパティは、ショートカットが自動的に繰り返されるかどうかを保持します。

デフォルト値はtrue です。


context : enumeration

このプロパティはshortcut context を保持します。

サポートされている値は以下の通りです：

定数説明
Qt.WindowShortcut(既定値) 親アイテムがアクティブなトップレベル・ウィンドウにあるとき、ショートカットはアクティブになります。
Qt.ApplicationShortcutショートカットは、アプリケーションのいずれかのウィンドウがアクティブなときにアクティブになります。
Shortcut {
    sequence: StandardKey.Quit
    context: Qt.ApplicationShortcut
    onActivated: Qt.quit()
}

enabled : bool

このプロパティは、ショートカットが有効かどうかを保持します。

既定値はtrue です。


nativeText : string [read-only]

このプロパティは、ショートカットのキーシーケンスをプラットフォーム固有の文字列として提供します。つまり、翻訳されて表示され、macOSではメニューバーのキー配列に似ています。このテキストはユーザーに表示するのがベストです（例えば、ツールチップ）。

sequence とportableTextも参照して ください。


portableText : string [read-only]

このプロパティは、ショートカットのキーシーケンスを、ファイルへの読み書きに適した「ポータブル」フォーマットの文字列として提供します。多くの場合、WindowsやX11のネイティブテキストと同じように見えます。

sequence およびnativeTextも参照してください 。


sequence : keysequence

このプロパティは、ショートカットのキーシーケンスを保持します。キー・シーケンスは、standard keyboard shortcuts のいずれかに設定することもできますし、activate ショートカットに必要な最大4つのキー押下シーケンスを含む文字列で記述することもできます。

デフォルト値は空のキー配列である。

Shortcut {
    sequence: "Ctrl+E,Ctrl+W"
    onActivated: edit.wrapMode = TextEdit.Wrap
}

注意： 標準キーは、あるプラットフォームでは1つのショートカットに解決されるが、他のプラットフォームでは複数のショートカットに解決されることがあるため、標準キーには常にsequences を使用することを推奨する。

sequencesも参照のこと 。


sequences : list<keysequence>

このプロパティは、ショートカットのための複数のキーシーケンスを保持します。キー配列は、standard keyboard shortcuts のいずれかに設定することもできますし、activate ショートカットに必要な最大4つのキー押下シーケンスを含む文字列で記述することもできます。

Shortcut {
    sequences: [StandardKey.Cut, "Ctrl+X", "Shift+Del"]
    onActivated: edit.cut()
}

シグナル・ドキュメント

activated()

このシグナルは、ショートカットがアクティブになったときに発せられます。

注： 対応するハンドラはonActivated です。


activatedAmbiguously()

このシグナルは、ショートカットが曖昧に起動されたとき、つまり複数のショートカットの開始キーにマッチしたときに発せられます。

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


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