このページでは

Shortcut QML Type

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

Import Statement: import QtQuick

プロパティ

信号

詳細な説明

「ショートカット」タイプを使用すると、キーボードショートカットを処理できます。ショートカットは、standard keyboard shortcuts のいずれかに設定するか、またはショートカットをactivate するために必要な最大4つのキーの押下順序を含む文字列で記述することができます。

Item {
    id: view

    property int currentIndex

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

また、複数のショートカットsequences を設定することも可能であり、それによって、いくつかの異なるキー押下シーケンスでショートカットをactivated できるようになります。

Keys およびshortcutOverride()も参照してください 。

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

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()
}

Signal ドキュメント

activated()

このシグナルは、ショートカットが起動されたときに発せられます。

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

activatedAmbiguously()

このシグナルは、ショートカットが曖昧にアクティブ化された場合、つまり複数のショートカットの先頭と一致した場合に発せられます。

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

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