QKeySequence Class

Dokumentation der Mitgliedsfunktionen

QKeySequence::QKeySequence()

Erstellt eine leere Schlüsselsequenz.

QKeySequence::QKeySequence(QKeySequence::StandardKey key)

Erstellt ein QKeySequence-Objekt für die angegebene Tastenkombination „ key “. Das Ergebnis hängt von der aktuell verwendeten Plattform ab.

Das resultierende Objekt basiert auf dem ersten Element in der Liste der Tastenbelegungen für das „ key “.

QKeySequence::QKeySequence(const QString &key, QKeySequence::SequenceFormat format = NativeText)

Erstellt eine Tastenkombination aus der Zeichenfolge „ key “, basierend auf format.

Beispielsweise ergibt „Ctrl+O“ die Tastenkombination STRG+'O'. Die Zeichenfolgen „Ctrl“, „Shift“, „Alt“ und „Meta“ werden erkannt, ebenso wie ihre übersetzten Entsprechungen im Kontext von „QShortcut “ (unter Verwendung von QObject::tr()).

Es können bis zu vier Tastencodes durch Kommas getrennt eingegeben werden, z. B. „Alt+X,Ctrl+S,Q“.

Dieser Konstruktor wird typischerweise mit ` tr()` verwendet, damit Tastenkombinationen in Übersetzungen ersetzt werden können:

QMenu *file = new QMenu(this);
file->addAction(tr("&Open..."), QKeySequence(tr("Ctrl+O", "File|Open")),
                this, &MainWindow::open);

Beachten Sie den Übersetzerkommentar „Datei|Öffnen“. Er ist keineswegs notwendig, bietet dem menschlichen Übersetzer jedoch etwas Kontext.

QKeySequence::QKeySequence(QKeyCombination k1, QKeyCombination k2 = QKeyCombination::fromCombined(0), QKeyCombination k3 = QKeyCombination::fromCombined(0), QKeyCombination k4 = QKeyCombination::fromCombined(0))

Erstellt eine Schlüsselsequenz mit bis zu 4 Schlüsseln: k1, k2, k3 und k4.

Siehe auch QKeyCombination.

QKeySequence::QKeySequence(int k1, int k2 = 0, int k3 = 0, int k4 = 0)

Erstellt eine Tastenkombination aus bis zu 4 Tasten: k1, k2, k3 und k4.

Die Tastencodes sind unter Qt::Key aufgeführt und können mit Modifikatoren (siehe Qt::KeyboardModifier) wie Qt::ShiftModifier, Qt::ControlModifier, Qt::AltModifier oder Qt::MetaModifier kombiniert werden.

QKeySequence::QKeySequence(const QKeySequence &keysequence)

Kopierkonstruktor. Erstellt eine Kopie von „ keysequence “.

[noexcept] QKeySequence::~QKeySequence()

Löscht die Tastenfolge.

int QKeySequence::count() const

Gibt die Anzahl der Schlüssel in der Schlüsselsequenz zurück. Der Höchstwert beträgt 4.

[static] QKeySequence QKeySequence::fromString(const QString &str, QKeySequence::SequenceFormat format = PortableText)

Gibt ein ` QKeySequence ` aus der Zeichenkette ` str ` zurück, basierend auf ` format`.

Siehe auch toString().

bool QKeySequence::isEmpty() const

Gibt „ true “ zurück, wenn die Tastenfolge leer ist; andernfalls wird „false“ zurückgegeben.

[static] QList<QKeySequence> QKeySequence::keyBindings(QKeySequence::StandardKey key)

Gibt eine Liste von Tastenkombinationen für die angegebene „ key “ zurück. Das Ergebnis des Aufrufs dieser Funktion hängt von der Zielplattform ab. Das erste Element der Liste gibt die primäre Tastenkombination für die jeweilige Plattform an. Enthält das Ergebnis mehr als einen Eintrag, können diese als alternative Tastenkombinationen auf derselben Plattform für die angegebene „ key “ betrachtet werden.

[static] QList<QKeySequence> QKeySequence::listFromString(const QString &str, QKeySequence::SequenceFormat format = PortableText)

Gibt eine Liste von „ QKeySequence “ aus der Zeichenkette „ str “ zurück, basierend auf „ format “.

Siehe auch fromString() und listToString().

[static] QString QKeySequence::listToString(const QList<QKeySequence> &list, QKeySequence::SequenceFormat format = PortableText)

Gibt eine Zeichenfolgendarstellung von „ list “ zurück, basierend auf „ format “.

Siehe auch toString() und listFromString().

QKeySequence::SequenceMatch QKeySequence::matches(const QKeySequence &seq) const

Sucht nach einer Übereinstimmung mit der Sequenz „ seq “. Gibt „ ExactMatch “ zurück, wenn die Suche erfolgreich war, „ PartialMatch “, wenn „ seq “ nur teilweise übereinstimmt, und „ NoMatch “, wenn die Sequenzen keine Gemeinsamkeiten aufweisen. Gibt „ NoMatch “ zurück, wenn „ seq “ kürzer ist.

[static] QKeySequence QKeySequence::mnemonic(const QString &text)

Gibt die Tastenkombination für das Mnemonik in ` text` zurück oder eine leere Tastenkombination, wenn keine Mnemoniken gefunden werden.

Beispielsweise gibt mnemonic("E&xit") „ Qt::ALT+Qt::Key_X “ zurück, mnemonic("&Quit") gibt „ ALT+Key_Q “ zurück und mnemonic("Quit") gibt eine leere Tastenkombination zurück: „ QKeySequence “.

[noexcept] void QKeySequence::swap(QKeySequence &other)

Tauscht diese Tastenfolge mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QString QKeySequence::toString(QKeySequence::SequenceFormat format = PortableText) const

Gibt eine Zeichenfolgenrepräsentation der Tastenkombination zurück, basierend auf format.

Beispielsweise ergibt der Wert Qt::CTRL+Qt::Key_O das Ergebnis „Ctrl+O“. Wenn die Tastenkombination mehrere Tastencodes enthält, werden diese in der zurückgegebenen Zeichenkette durch Kommas getrennt, z. B. „Alt+X, Ctrl+Y, Z“. Die Zeichenfolgen „Ctrl“, „Shift“ usw. werden mithilfe von ` QObject::tr()` im Kontext „QShortcut “ übersetzt.

Enthält die Tastenkombination keine Tasten, wird eine leere Zeichenkette zurückgegeben.

Auf Apple-Plattformen ähnelt die zurückgegebene Zeichenkette der Sequenz, die in der Menüleiste angezeigt wird, wenn „ format “ auf „ QKeySequence::NativeText “ gesetzt ist; andernfalls verwendet die Zeichenkette das „portable“ Format, das zum Schreiben in eine Datei geeignet ist.

Siehe auch fromString().

QKeySequence::operator QVariant() const

Gibt die Schlüsselsequenz als QVariant

bool QKeySequence::operator!=(const QKeySequence &other) const

Gibt „ true “ zurück, wenn diese Schlüsselsequenz nicht mit der Schlüsselsequenz „ other “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.

bool QKeySequence::operator<(const QKeySequence &other) const

Führt einen beliebigen Vergleich zwischen dieser Schlüsselsequenz und der Schlüsselsequenz other durch. Es wird lediglich garantiert, dass der Operator false zurückgibt, wenn beide Schlüsselsequenzen gleich sind, und dass (ks1 < ks2) == !(ks2 < ks1) gilt, wenn die Schlüsselsequenzen nicht gleich sind.

Diese Funktion ist unter bestimmten Umständen nützlich, beispielsweise wenn Sie „ QKeySequence “-Objekte als Schlüssel in einem „ QMap “ verwenden möchten.

Siehe auch „ operator==()“, „ operator!=()“, „ operator>()“, „ operator<=()“ und „ operator>=()“.

bool QKeySequence::operator<=(const QKeySequence &other) const

Gibt „ true “ zurück, wenn diese Schlüsselsequenz kleiner oder gleich der Schlüsselsequenz „ other “ ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch operator==(), operator!=(), operator<(), operator>() und operator>=().

[noexcept] QKeySequence &QKeySequence::operator=(QKeySequence &&other)

Weist „ other “ dieser „ QKeySequence “-Instanz zu.

QKeySequence &QKeySequence::operator=(const QKeySequence &other)

Zuweisungsoperator. Weist diesem Objekt die Tastenfolge „ other “ zu.

bool QKeySequence::operator==(const QKeySequence &other) const

Gibt „ true “ zurück, wenn diese Schlüsselsequenz mit der Schlüsselsequenz „ other “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.

bool QKeySequence::operator>(const QKeySequence &other) const

Gibt „ true “ zurück, wenn diese Schlüsselsequenz größer ist als die Schlüsselsequenz „ other “; andernfalls wird „ false “ zurückgegeben.

Siehe auch operator==(), operator!=(), operator<(), operator<=() und operator>=().

bool QKeySequence::operator>=(const QKeySequence &other) const

Gibt „ true “ zurück, wenn diese Schlüsselsequenz größer oder gleich der Schlüsselsequenz „ other “ ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch operator==(), operator!=(), operator<(), operator>() und operator<=().

QKeyCombination QKeySequence::operator[](uint index) const

Gibt eine Referenz auf das Element an der Position index in der Schlüsselsequenz zurück. Dies kann nur zum Auslesen eines Elements verwendet werden.