QPushButton Class

Ausführliche Beschreibung

Die Schaltfläche, auch Befehlsschaltfläche genannt, ist wohl das am häufigsten verwendete Widget in jeder grafischen Benutzeroberfläche. Durch Drücken (Klicken) einer Schaltfläche wird der Computer angewiesen, eine bestimmte Aktion auszuführen oder eine Frage zu beantworten. Typische Schaltflächen sind „OK“, „Übernehmen“, „Abbrechen“, „Schließen“, „Ja“, „Nein“ und „Hilfe“.

Eine Befehlsschaltfläche ist rechteckig und zeigt in der Regel eine Textbeschriftung an, die ihre Aktion beschreibt. Eine Tastenkombination kann festgelegt werden, indem dem gewünschten Zeichen im Text ein Und-Zeichen vorangestellt wird. Zum Beispiel:

QPushButton *button = new QPushButton("&Download", this);

In diesem Beispiel lautet die Tastenkombination „Alt+D“. Weitere Informationen finden Sie in der Dokumentation zu „ QShortcut “ (um ein echtes Und-Zeichen anzuzeigen, verwenden Sie „&&“).

Drucktasten zeigen eine Textbeschriftung und optional ein kleines Symbol an. Diese können mithilfe der Konstruktoren festgelegt und später mit den Methoden ` setText()` und ` setIcon()` geändert werden. Ist die Schaltfläche deaktiviert, wird die Darstellung des Textes und des Symbols entsprechend dem GUI-Stil angepasst, damit die Schaltfläche „deaktiviert“ aussieht.

Eine Drucktaste sendet das Signal ` clicked()` aus, wenn sie mit der Maus, der Leertaste oder über eine Tastenkombination aktiviert wird. Verbinden Sie sich mit diesem Signal, um die Aktion der Taste auszuführen. Drucktasten stellen auch weniger häufig verwendete Signale bereit, zum Beispiel ` pressed()` und ` released()`.

connect(dispenseButton, &QPushButton::clicked, this, &IceCreamMaker::dispense);

Befehlsschaltflächen in Dialogfeldern sind standardmäßig „Auto-Default“-Schaltflächen, d. h., sie werden automatisch zur Standardschaltfläche, sobald sie den Tastatureingabefokus erhalten. Eine Standardschaltfläche ist eine Schaltfläche, die aktiviert wird, wenn der Benutzer in einem Dialogfeld die Eingabetaste (Enter oder Return) drückt. Sie können dies mit ` setAutoDefault()` ändern. Beachten Sie, dass automatische Standardschaltflächen etwas zusätzlichen Platz reservieren, der zum Zeichnen eines Standardschaltflächen-Indikators erforderlich ist. Wenn Sie diesen Platz um Ihre Schaltflächen herum nicht wünschen, rufen Sie ` setAutoDefault(false)` auf.

Da das Schaltflächen-Widget eine so zentrale Rolle spielt, hat es sich in den letzten zehn Jahren weiterentwickelt und bietet nun eine Vielzahl von Varianten. Der Microsoft-Styleguide zeigt mittlerweile etwa zehn verschiedene Zustände von Windows-Schaltflächen, und der Text lässt vermuten, dass es Dutzende weitere gibt, wenn man alle Kombinationen von Funktionen berücksichtigt.

Die wichtigsten Modi oder Zustände sind:

• Verfügbar oder nicht (ausgegraut, deaktiviert).
• Standard-Druckknopf, Umschalt-Druckknopf oder Menü-Druckknopf.
• Ein oder Aus (nur für Umschalt-Drucktasten).
• Standard oder normal. Die Standardschaltfläche in einem Dialogfeld kann in der Regel mit der Eingabetaste oder der Return-Taste „angeklickt“ werden.
• Automatische Wiederholung oder nicht.
• Gedrückt oder nicht.

Als allgemeine Regel gilt: Verwenden Sie eine Schaltfläche, wenn die Anwendung oder das Dialogfenster eine Aktion ausführt, sobald der Benutzer darauf klickt (z. B. „Übernehmen“, „Abbrechen“, „Schließen“ und „Hilfe“), und wenn das Widget eine breite, rechteckige Form mit einer Textbeschriftung haben soll. Kleine, typischerweise quadratische Schaltflächen, die den Zustand des Fensters ändern, anstatt eine Aktion auszuführen (wie z. B. die Schaltflächen in der oberen rechten Ecke des „ QFileDialog “), sind keine Befehlsschaltflächen, sondern Werkzeugschaltflächen. Qt stellt für diese Schaltflächen eine spezielle Klasse (QToolButton) bereit.

Wenn Sie ein Umschaltverhalten benötigen (siehe setCheckable()) oder eine Schaltfläche, die das Aktivierungssignal beim Herunterdrücken automatisch wiederholt, wie die Pfeile in einer Bildlaufleiste (siehe setAutoRepeat()), ist eine Befehlsschaltfläche wahrscheinlich nicht das Richtige für Sie. Im Zweifelsfall sollten Sie eine Werkzeugschaltfläche verwenden.

Eine Variante der Befehlsschaltfläche ist die Menüschaltfläche. Diese bietet nicht nur einen, sondern mehrere Befehle, da beim Klicken ein Menü mit Optionen angezeigt wird. Verwenden Sie die Methode ` setMenu()` (), um einer Schaltfläche ein Popup-Menü zuzuweisen.

Weitere Klassen von Schaltflächen sind Optionsschaltflächen (siehe QRadioButton) und Kontrollkästchen (siehe QCheckBox).

In Qt stellt die Basisklasse ` QAbstractButton ` die meisten Modi und weitere API-Funktionen bereit, während `QPushButton` die GUI-Logik bereitstellt. Weitere Informationen zur API finden Sie unter QAbstractButton.