QPushButton Class

Detaillierte Beschreibung

Die Drucktaste oder Befehlsschaltfläche ist vielleicht das am häufigsten verwendete Widget in einer grafischen Benutzeroberfläche. Drücken (klicken) Sie auf eine Schaltfläche, um dem Computer zu befehlen, eine Aktion durchzufü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 die jeweilige Aktion beschreibt. Ein Tastenkürzel kann angegeben werden, indem dem gewünschten Zeichen ein kaufmännisches Und im Text vorangestellt wird. Ein Beispiel:

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

In diesem Beispiel lautet das Tastenkürzel Alt+D. Weitere Informationen finden Sie in der Dokumentation QShortcut (um ein echtes kaufmännisches Und-Zeichen anzuzeigen, verwenden Sie '&&').

Drucktasten zeigen eine textuelle Beschriftung und optional ein kleines Symbol an. Diese können mit den Konstruktoren festgelegt und später mit setText() und setIcon() geändert werden. Wenn die Schaltfläche deaktiviert ist, wird das Aussehen des Textes und des Symbols in Bezug auf den GUI-Stil manipuliert, damit die Schaltfläche "deaktiviert" aussieht.

Eine Drucktaste gibt das Signal clicked() aus, wenn sie mit der Maus, der Leertaste oder einem Tastaturkürzel aktiviert wird. Verbinden Sie sich mit diesem Signal, um die Aktion der Taste auszuführen. Drucktasten liefern auch weniger gebräuchliche Signale, zum Beispiel pressed() und released().

Befehlsschaltflächen in Dialogen sind standardmäßig Auto-Default-Schaltflächen, d. h., sie werden automatisch zur Standard-Drucktaste, wenn sie den Fokus der Tastatureingabe erhalten. Eine Standardschaltfläche ist eine Drucktaste, die aktiviert wird, wenn der Benutzer die Enter- oder Return-Taste in einem Dialog drückt. Sie können dies mit setAutoDefault() ändern. Beachten Sie, dass automatische Standardschaltflächen einen kleinen zusätzlichen Platz reservieren, der notwendig ist, um eine Standardschaltflächenanzeige zu zeichnen. Wenn Sie diesen Platz um Ihre Schaltflächen nicht wünschen, rufen Sie setAutoDefault(false) auf.

Da das Schaltflächen-Widget so zentral ist, hat es in den letzten zehn Jahren eine Vielzahl von Variationen angenommen. Der Microsoft-Styleguide zeigt jetzt etwa zehn verschiedene Zustände von Windows-Tasten, und der Text deutet an, dass es noch Dutzende weiterer gibt, wenn alle Kombinationen von Funktionen berücksichtigt werden.

Die wichtigsten Modi oder Zustände sind:

• Verfügbar oder nicht (ausgegraut, deaktiviert).
• Standarddrucktaste, Umschalttaste oder Menütaste.
• An oder aus (nur bei Umschalttasten).
• Standard oder normal. Die Standardtaste in einem Dialog kann in der Regel mit der Enter- oder Return-Taste "angeklickt" werden.
• Auto-Wiederholung oder nicht.
• Niedergedrückt oder nicht.

Als allgemeine Regel gilt: Verwenden Sie eine Drucktaste, wenn die Anwendung oder das Dialogfenster eine Aktion ausführt, wenn der Benutzer darauf klickt (z. B. Anwenden, 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 die Schaltflächen in der oberen rechten Ecke von QFileDialog), sind keine Befehlsschaltflächen, sondern Werkzeugschaltflächen. Qt bietet eine spezielle Klasse (QToolButton) für diese Schaltflächen.

Wenn Sie ein Umschaltverhalten benötigen (siehe setCheckable()) oder eine Schaltfläche, die das Aktivierungssignal automatisch wiederholt, wenn sie nach unten gedrückt wird, wie die Pfeile in einer Bildlaufleiste (siehe setAutoRepeat()), ist eine Befehlsschaltfläche wahrscheinlich nicht das, was Sie wollen. Verwenden Sie im Zweifelsfall eine Werkzeugschaltfläche.

Eine Variante einer Befehlsschaltfläche ist eine Menüschaltfläche. Diese bieten nicht nur einen, sondern mehrere Befehle, denn wenn sie angeklickt werden, öffnet sich ein Menü mit Optionen. Verwenden Sie die Methode setMenu(), um ein Popup-Menü mit einer Drucktaste zu verknüpfen.

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

In Qt stellt die Basisklasse QAbstractButton die meisten Modi und andere APIs zur Verfügung, während QPushButton die GUI-Logik liefert. Siehe QAbstractButton für weitere Informationen über die API.