QShortcut Class

shortcut = new QShortcut(QKeySequence(tr("Ctrl+O", "File|Open")),
                        parent);

setKey(0);                  // no signal emitted
setKey(QKeySequence());     // no signal emitted
setKey(0x3b1);              // Greek letter alpha
setKey(Qt::Key_D);              // 'd', e.g. to delete
setKey('q');                // 'q', e.g. to quit
setKey(Qt::CTRL | Qt::Key_P);       // Ctrl+P, e.g. to print document
setKey(tr("Ctrl+P"));           // Ctrl+P, e.g. to print document

Documentation sur les fonctions de membre

[explicit] QShortcut::QShortcut(QObject *parent)

Crée un objet QShortcut pour l'parent, qui doit être une QWindow ou une QWidget.

Comme aucune séquence de touches de raccourci n’est spécifiée, le raccourci n’émettra aucun signal.

Voir également setKey().

[explicit, since 6.0] QShortcut::QShortcut(QKeySequence::StandardKey standardKey, QObject *parent, const char *member = nullptr, const char *ambiguousMember = nullptr, Qt::ShortcutContext context = Qt::WindowShortcut)

Crée un objet QShortcut pour l'parent, qui doit être un QWindow ou un QWidget.

Le raccourci agit sur son parent, en surveillant les événements « QShortcutEvent» qui correspondent à l’« standardKey ». En fonction de l’ambiguïté de l’événement, le raccourci appellera la fonction « member » ou la fonction « ambiguousMember », si la touche enfoncée se trouve dans la zone de « context » du raccourci.

Cette fonction a été introduite dans Qt 6.0.

[explicit] QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const char *member = nullptr, const char *ambiguousMember = nullptr, Qt::ShortcutContext context = Qt::WindowShortcut)

Crée un objet QShortcut pour l'parent, qui doit être un QWindow ou un QWidget.

Le raccourci agit sur son parent, en surveillant les événements « QShortcutEvent» qui correspondent à la séquence de « key ». En fonction de l’ambiguïté de l’événement, le raccourci appellera la fonction « member » ou la fonction « ambiguousMember », si la touche enfoncée se trouvait dans l’ context du raccourci.

[since 6.0] template <typename Functor> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Il s'agit d'un constructeur pratique de QShortcut qui relie le signal ` activated()` du raccourci à la fonction ` functor`.

Cette fonction a été introduite dans Qt 6.0.

template <typename Functor> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Il s'agit d'un constructeur pratique de QShortcut qui relie le signal ` activated()` du raccourci à la fonction ` functor`.

[since 6.0] template <typename Functor> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Il s'agit d'un constructeur pratique de QShortcut qui relie le signal ` activated()` du raccourci à ` functor`.

La fonction ` functor ` peut être un pointeur vers une fonction membre de l'objet ` context `.

Si l'objet ` context ` est détruit, la fonction ` functor ` ne sera pas appelée.

Cette fonction a été introduite dans Qt 6.0.

template <typename Functor> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const QObject *context, Functor functor, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Il s'agit d'un constructeur de commodité de QShortcut qui relie le signal activated() du raccourci à functor.

La fonction ` functor ` peut être un pointeur vers une fonction membre de l'objet ` context `.

Si l'objet context est détruit, la fonction functor ne sera pas appelée.

[since 6.0] template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context, Functor functor, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Il s'agit d'un constructeur pratique de QShortcut qui relie le signal activated() du raccourci à functor et le signal activatedAmbiguously() à functorAmbiguous.

Les signaux functor et functorAmbiguous peuvent être des pointeurs vers une fonction membre de l’objet context.

Si l’objet context est détruit, les fonctions functor et functorAmbiguous ne seront pas appelées.

Cette fonction a été introduite dans Qt 6.0.

template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const QObject *context, Functor functor, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Il s'agit d'un constructeur pratique de QShortcut qui relie le signal ` activated()` du raccourci à ` functor ` et le signal ` activatedAmbiguously()` à ` functorAmbiguous`.

Les signaux functor et functorAmbiguous peuvent être des pointeurs vers une fonction membre de l’objet context.

Si l'objet context est détruit, les fonctions functor et functorAmbiguous ne seront pas appelées.

[since 6.0] template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(QKeySequence::StandardKey key, QObject *parent, const QObject *context1, Functor functor, const QObject *context2, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Il s'agit d'un constructeur pratique de QShortcut qui relie le signal ` activated()` du raccourci à ` functor ` et le signal ` activatedAmbiguously()` à ` functorAmbiguous`.

functor peut être un pointeur vers une fonction membre de l’objet context1. functorAmbiguous peut être un pointeur vers une fonction membre de l’objet context2.

Si l’objet context1 est détruit, la fonction functor ne sera pas appelée. Si l’objet context2 est détruit, la fonction functorAmbiguous ne sera pas appelée.

Cette fonction a été introduite dans Qt 6.0.

template <typename Functor, typename FunctorAmbiguous> QShortcut::QShortcut(const QKeySequence &key, QObject *parent, const QObject *context1, Functor functor, const QObject *context2, FunctorAmbiguous functorAmbiguous, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

Il s'agit d'un constructeur pratique de QShortcut qui relie le signal activated() du raccourci à l'functor et le signal activatedAmbiguously() à l'functorAmbiguous.

functor peut être un pointeur vers une fonction membre de l’objet context1. functorAmbiguous peut être un pointeur vers une fonction membre de l’objet context2.

Si l’objet context1 est détruit, la fonction functor ne sera pas appelée. Si l’objet context2 est détruit, la fonction functorAmbiguous ne sera pas appelée.

[virtual noexcept] QShortcut::~QShortcut()

Supprime le raccourci.

[signal] void QShortcut::activated()

Ce signal est émis lorsque l'utilisateur tape la séquence de touches correspondant au raccourci.

Voir également activatedAmbiguously().

[signal] void QShortcut::activatedAmbiguously()

Lorsqu'une séquence de touches est saisie au clavier, elle est considérée comme ambiguë tant qu'elle correspond au début de plusieurs raccourcis.

Lorsque la séquence de touches d’un raccourci est terminée, la fonction activatedAmbiguously() est émise si la séquence de touches est toujours ambiguë (c’est-à-dire si elle correspond au début d’un ou plusieurs autres raccourcis). Le signal activated() n’est pas émis dans ce cas.

Voir également activated().

[since 6.0] QList<QKeySequence> QShortcut::keys() const

Renvoie la liste des combinaisons de touches qui déclenchent ce raccourci.

Cette fonction a été introduite dans Qt 6.0.

Voir également ` key ` et ` setKeys()`.

QWidget *QShortcut::parentWidget() const

Renvoie le widget parent du raccourci.

[since 6.0] void QShortcut::setKeys(QKeySequence::StandardKey key)

Définit les déclencheurs sur ceux correspondant à l'key standard des touches.

Cette fonction a été introduite dans Qt 6.0.

Voir également key et keys().

[since 6.0] void QShortcut::setKeys(const QList<QKeySequence> &keys)

Définit ` keys ` comme liste des séquences de touches qui déclenchent le raccourci.

Cette fonction a été introduite dans Qt 6.0.

Voir également key et keys().

void QShortcut::setWhatsThis(const QString &text)

Définit l'text d'aide « Qu'est-ce que c'est ? » du raccourci.

Ce texte s'affiche lorsqu'une application de widget est en mode « Qu'est-ce que c'est ? » et que l'utilisateur saisit la séquence de raccourcis key().

Pour définir l'aide « Qu'est-ce que c'est ? » sur un élément de menu (avec ou sans touche de raccourci), définissez l'aide sur l'action de l'élément.

Par défaut, le texte d’aide est une chaîne vide.

Cette fonction n’a aucun effet dans les applications qui n’utilisent pas de widgets.

Voir également whatsThis(), QWhatsThis::inWhatsThisMode() et QAction::setWhatsThis().

QString QShortcut::whatsThis() const

Renvoie le texte d'aide « Qu'est-ce que c'est ? » du raccourci.

Voir aussi setWhatsThis().