QKeySequence Class

Detaillierte Beschreibung

In ihrer gebräuchlichsten Form beschreibt eine Tastensequenz eine Kombination von Tasten, die zusammen verwendet werden müssen, um eine Aktion auszuführen. Tastensequenzen werden mit QAction Objekten verwendet, um festzulegen, welche Tastenkombinationen verwendet werden können, um Aktionen auszulösen.

Tastensequenzen können auf drei verschiedene Arten für die Verwendung als Tastenkombinationen erstellt werden:

• Für Standard-Tastenkombinationen kann eine standard key verwendet werden, um die plattformspezifische Tastensequenz abzufragen, die mit jeder Tastenkombination verbunden ist.
• Für benutzerdefinierte Tastenkombinationen können von Menschen lesbare Zeichenfolgen wie "Strg+X" verwendet werden, die für Benutzer verschiedener Sprachen in die entsprechenden Tastenkombinationen übersetzt werden können. Die Übersetzungen werden im Kontext von "QShortcut" vorgenommen.
• Für fest codierte Tastenkombinationen können ganzzahlige Tastencodes mit einer Kombination von Werten angegeben werden, die durch die Enum-Werte Qt::Key und Qt::KeyboardModifier definiert sind. Jeder Tastencode besteht aus einem einzelnen Wert Qt::Key und null oder mehr Modifikatoren, wie Qt::ShiftModifier, Qt::ControlModifier, Qt::AltModifier und Qt::MetaModifier.

Ctrl P könnte beispielsweise eine Sequenz sein, die als Abkürzung für das Drucken eines Dokuments verwendet wird, und kann auf jede der folgenden Arten angegeben werden:

QKeySequence(QKeySequence::Print);
QKeySequence(tr("Ctrl+P"));
QKeySequence(tr("Ctrl+p"));
QKeySequence(Qt::CTRL | Qt::Key_P);
QKeySequence(Qt::CTRL + Qt::Key_P); // deprecated

Beachten Sie, dass bei Buchstaben die Groß- und Kleinschreibung in der Zeichenkette keine Rolle spielt. In den obigen Beispielen muss der Benutzer die Taste Shift nicht gedrückt halten, um eine mit "Strg+P" angegebene Tastenkombination zu aktivieren. Bei anderen Tasten kann die Verwendung von Shift als nicht spezifizierte zusätzliche Modifikatortaste jedoch zu Verwirrung bei Benutzern einer Anwendung führen, deren Tastaturen ein anderes Layout haben als die von den Entwicklern verwendeten. Siehe den Abschnitt Keyboard Layout Issues weiter unten für weitere Details.

Es ist vorzuziehen, wenn möglich, Standard-Tastenkombinationen zu verwenden. Bei der Erstellung von Tastenkombinationen für Nicht-Standard-Tastenkombinationen sollten Sie menschenlesbare Strings anstelle von hart kodierten Integer-Werten verwenden.

QKeySequence-Objekte können in QString umgewandelt werden, um eine menschenlesbare, übersetzte Version der Sequenz zu erhalten. In ähnlicher Weise erzeugt die Funktion toString() menschenlesbare Zeichenketten für die Verwendung in Menüs. Auf Apple-Plattformen werden die entsprechenden Symbole verwendet, um Tastenkombinationen mit speziellen Tasten auf der Macintosh-Tastatur zu beschreiben.

Ein alternativer Weg, um fest kodierte Tastencodes zu spezifizieren, ist die Verwendung des Unicode-Codepunkts des Zeichens; zum Beispiel ergibt 'A' die gleiche Tastenfolge wie Qt::Key_A.

Standard-Tastenkombinationen

QKeySequence definiert viele standard keyboard shortcuts, um den Aufwand beim Einrichten von Aktionen in einer typischen Anwendung zu reduzieren. Die folgende Tabelle zeigt einige gängige Tastenkombinationen, die von Anwendungen auf vier weit verbreiteten Plattformen häufig für diese Standard-Shortcuts verwendet werden. Beachten Sie, dass auf Apple-Plattformen der Wert Ctrl den Tasten Command auf der Macintosh-Tastatur entspricht, und der Wert Meta den Tasten Control.

Beachten Sie, dass sich die für die Standardtastenkombinationen verwendeten Tastenkombinationen von Plattform zu Plattform unterscheiden. Daher müssen Sie Ihre Tastenkombinationen auf jeder Plattform testen, um sicherzustellen, dass Sie nicht versehentlich vielen Aktionen dieselbe Tastenfolge zuweisen.

Probleme mit dem Tastaturlayout

Viele Tastenkombinationen werden von den Entwicklern auf der Grundlage des Layouts bestimmter Tastaturtypen ausgewählt, anstatt Tasten zu wählen, die den ersten Buchstaben des Aktionsnamens darstellen, wie z. B. Ctrl S ("Strg+S") oder Ctrl C ("Strg+C"). Da bestimmte Symbole nur mit Hilfe von Sondertasten auf bestimmten Tastaturlayouts eingegeben werden können, kann es vorkommen, dass Tastenkombinationen, die für ein bestimmtes Tastaturlayout vorgesehen sind, auf einer anderen Taste liegen, auf gar keiner Taste liegen oder eine zusätzliche Sondertaste erfordern, um auf anderen Tastaturlayouts verwendet zu werden.

So werden beispielsweise die Tastenkombinationen Ctrl plus und Ctrl minus häufig als Tastenkombinationen für Zoomoperationen in Grafikanwendungen verwendet, die als "Strg++" bzw. "Strg+-" angegeben werden können. Die Art und Weise, wie diese Tastenkombinationen angegeben und interpretiert werden, hängt jedoch von der Tastaturbelegung ab. Benutzer norwegischer Tastaturen werden feststellen, dass die Tasten + und - auf der Tastatur nicht nebeneinander liegen, können aber dennoch beide Tastenkombinationen aktivieren, ohne die Taste Shift drücken zu müssen. Benutzer britischer Tastaturen müssen jedoch die Taste Shift gedrückt halten, um das Symbol + einzugeben, so dass die Tastenkombination praktisch dasselbe ist wie "Strg+Umschalt+=".

Auch wenn manche Entwickler alle Modifikatoren, die sie auf ihren Tastaturen verwenden, vollständig angeben, um ein Tastaturkürzel zu aktivieren, führt dies zu unerwartetem Verhalten bei Benutzern mit unterschiedlichen Tastaturlayouts.

Ein Entwickler, der eine britische Tastatur verwendet, könnte sich beispielsweise dafür entscheiden, "Strg+Umschalt+=" als Tastenfolge anzugeben, um eine Tastenkombination zu erstellen, die sich zufällig genauso verhält wie Ctrl plus. Auf die Taste = muss jedoch mit der Taste Shift auf der norwegischen Tastatur zugegriffen werden, wodurch die gewünschte Tastenkombination tatsächlich Ctrl Shift Shift = (eine unmögliche Tastenkombination) ist.

Daher können sowohl von Menschen lesbare Zeichenketten als auch fest kodierte Tastencodes problematisch sein, wenn es darum geht, eine Tastenfolge festzulegen, die auf einer Vielzahl unterschiedlicher Tastaturlayouts verwendet werden kann. Nur die Verwendung von standard shortcuts garantiert, dass der Benutzer die Tastenkombinationen verwenden kann, die der Entwickler vorgesehen hat.

Trotzdem können wir dieses Problem lösen, indem wir sicherstellen, dass menschenlesbare Zeichenketten verwendet werden, die es ermöglichen, Übersetzungen von Tastenkombinationen für Benutzer verschiedener Sprachen zu erstellen. Dieser Ansatz wird für Benutzer erfolgreich sein, deren Tastaturen das typische Layout für die Sprache haben, die sie benutzen.

Tastensequenzen im Stil von GNU Emacs

Tastensequenzen, die denen in GNU Emacs ähneln und bis zu vier Tastencodes erlauben, können mit dem Konstruktor für mehrere Argumente oder durch Übergabe einer menschenlesbaren Zeichenkette mit durch Kommata getrennten Tastensequenzen erstellt werden.

Zum Beispiel kann die Schlüsselsequenz Ctrl X, gefolgt von Ctrl C, auf eine der folgenden Arten angegeben werden:

QKeySequence(tr("Ctrl+X, Ctrl+C"));
QKeySequence(Qt::CTRL | Qt::Key_X, Qt::CTRL | Qt::Key_C);
QKeySequence(Qt::CTRL + Qt::Key_X, Qt::CTRL + Qt::Key_C); // deprecated