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

Dokumentation zu Mitgliedsfunktionen

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

Erstellt ein QShortcut-Objekt für die „ parent “, bei der es sich um eine „ QWindow “ oder eine „ QWidget “ handeln sollte.

Da keine Tastenkombination angegeben ist, gibt die Tastenkombination keine Signale aus.

Siehe auch 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)

Erstellt ein QShortcut-Objekt für die „ parent “, bei der es sich um eine „ QWindow “ oder eine „ QWidget “ handeln sollte.

Der Shortcut wirkt auf sein übergeordnetes Element ein und überwacht „ QShortcutEvents“, die mit dem „ standardKey “ übereinstimmen. Je nach Mehrdeutigkeit des Ereignisses ruft der Shortcut entweder die Funktion „ member “ oder die Funktion „ ambiguousMember “ auf, sofern der Tastendruck im „ context “ des Shortcuts erfolgte.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Erstellt ein QShortcut-Objekt für die „ parent “, die entweder ein „ QWindow “ oder ein „ QWidget “ sein sollte.

Die Tastenkombination wirkt auf ihr übergeordnetes Element ein und überwacht „ QShortcutEvents“, die der „ key “-Sequenz entsprechen. Je nach Mehrdeutigkeit des Ereignisses ruft die Tastenkombination entweder die Funktion „ member “ oder die Funktion „ ambiguousMember “ auf, sofern der Tastendruck im „ context “ der Tastenkombination erfolgte.

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

Dies ist ein QShortcut-Komfortkonstruktor, der das Signal „ activated()“ der Verknüpfung mit „ functor “ verbindet.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Dies ist ein QShortcut-Komfortkonstruktor, der das Signal „ activated()“ des Shortcuts mit „ functor “ verbindet.

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

Dies ist ein QShortcut-Komfortkonstruktor, der das Signal „ activated()“ der Verknüpfung mit „ functor “ verbindet.

functor kann ein Zeiger auf eine Mitgliedsfunktion des Objekts „ context “ sein.

Wird das „ context “-Objekt zerstört, wird „ functor “ nicht aufgerufen.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Dies ist ein Komfortkonstruktor von QShortcut, der das Signal „ activated()“ der Verknüpfung mit „ functor “ verbindet.

functor kann ein Zeiger auf eine Mitgliedsfunktion des context -Objekts sein.

Wird das „ context “-Objekt zerstört, wird „ functor “ nicht aufgerufen.

[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)

Dies ist ein QShortcut-Komfortkonstruktor, der das Signal „ activated()“ des Shortcuts mit „ functor “ und das Signal „ activatedAmbiguously()“ mit „ functorAmbiguous “ verbindet.

functor und functorAmbiguous können ein Zeiger auf eine Mitgliedsfunktion des context -Objekts sein.

Wird das Objekt ` context ` zerstört, werden ` functor ` und ` functorAmbiguous ` nicht aufgerufen.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Dies ist ein QShortcut-Komfortkonstruktor, der das Signal „ activated()“ des Shortcuts mit „ functor “ und das Signal „ activatedAmbiguously()“ mit „ functorAmbiguous “ verbindet.

functor und functorAmbiguous können ein Zeiger auf eine Mitgliedsfunktion des context -Objekts sein.

Wird das Objekt „ context “ zerstört, werden „ functor “ und „ functorAmbiguous “ nicht aufgerufen.

[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)

Dies ist ein QShortcut-Komfortkonstruktor, der das Signal „ activated()“ der Verknüpfung mit „ functor “ und das Signal „ activatedAmbiguously()“ mit „ functorAmbiguous “ verbindet.

functor kann ein Zeiger auf eine Mitgliedsfunktion des context1 -Objekts sein. functorAmbiguous kann ein Zeiger auf eine Mitgliedsfunktion des context2 -Objekts sein.

Wird das Objekt „ context1 “ zerstört, wird „ functor “ nicht aufgerufen. Wird das Objekt „ context2 “ zerstört, wird „ functorAmbiguous “ nicht aufgerufen.

Diese Funktion wurde in Qt 6.0 eingeführt.

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)

Dies ist ein QShortcut-Komfortkonstruktor, der das Signal „ activated()“ der Verknüpfung mit „ functor “ und das Signal „ activatedAmbiguously()“ mit „ functorAmbiguous “ verbindet.

functor kann ein Zeiger auf eine Mitgliedsfunktion des Objekts „ context1 “ sein. functorAmbiguous kann ein Zeiger auf eine Mitgliedsfunktion des Objekts „ context2 “ sein.

Wird das Objekt „ context1 “ zerstört, wird „ functor “ nicht aufgerufen. Wird das Objekt „ context2 “ zerstört, wird „ functorAmbiguous “ nicht aufgerufen.

[virtual noexcept] QShortcut::~QShortcut()

Löscht die Verknüpfung.

[signal] void QShortcut::activated()

Dieses Signal wird ausgelöst, wenn der Benutzer die Tastenkombination eingibt.

Siehe auch „ activatedAmbiguously()“.

[signal] void QShortcut::activatedAmbiguously()

Wenn eine Tastenfolge über die Tastatur eingegeben wird, gilt sie als mehrdeutig, solange sie mit dem Anfang von mehr als einem Tastenkürzel übereinstimmt.

Wenn die Tastenfolge eines Tastenkürzels vollständig eingegeben wurde, wird `activatedAmbiguously()` ausgelöst, sofern die Tastenfolge weiterhin mehrdeutig ist (d. h., sie ist der Anfang eines oder mehrerer anderer Tastenkürzel). Das Signal ` activated()` wird in diesem Fall nicht ausgelöst.

Siehe auch ` activated()`.

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

Gibt die Liste der Tastenkombinationen zurück, die diesen Shortcut auslösen.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch „ key “ und „ setKeys()“.

QWidget *QShortcut::parentWidget() const

Gibt das übergeordnete Widget des Shortcuts zurück.

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

Setzt die Trigger auf diejenigen, die dem Standard-Tasten key entsprechen.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` key ` und ` keys()`.

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

Legt „ keys “ als Liste der Tastenfolgen fest, die den Tastenbefehl auslösen.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch „ key “ und „ keys()“.

void QShortcut::setWhatsThis(const QString &text)

Legt den „Was ist das?“-Hilfe text des Shortcuts fest.

Der Text wird angezeigt, wenn sich eine Widget-Anwendung im „Was ist das?“-Modus befindet und der Benutzer die Tastenkombination key() eingibt.

Um die „Was ist das?“-Hilfe für einen Menüpunkt (mit oder ohne Tastenkombination) festzulegen, legen Sie die Hilfe für die Aktion des Menüpunkts fest.

Standardmäßig ist der Hilfetext eine leere Zeichenkette.

Diese Funktion hat in Anwendungen, die keine Widgets verwenden, keine Auswirkung.

Siehe auch whatsThis(), QWhatsThis::inWhatsThisMode() und QAction::setWhatsThis().

QString QShortcut::whatsThis() const

Gibt den Hilfetext „Was ist das?“ des Shortcuts zurück.

Siehe auch „ setWhatsThis()“.