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 です。


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