QAbstractButton Class

Dokumentation zu den Member-Funktionen

[explicit] QAbstractButton::QAbstractButton(QWidget *parent = nullptr)

Erstellt eine abstrakte Schaltfläche mit einem „ parent “.

[virtual noexcept] QAbstractButton::~QAbstractButton()

Löscht die Schaltfläche.

[slot] void QAbstractButton::animateClick()

Führt einen animierten Klick aus: Die Schaltfläche wird sofort gedrückt und 100 ms später wieder losgelassen.

Wird diese Funktion erneut aufgerufen, bevor die Schaltfläche losgelassen wird, wird der Loslass-Timer zurückgesetzt.

Alle mit einem Klick verbundenen Signale werden entsprechend ausgelöst.

Diese Funktion führt keine Aktion aus, wenn die Schaltfläche disabled.

Siehe auch ` click()`.

[override virtual protected] void QAbstractButton::changeEvent(QEvent *e)

Umsetzt: ` QWidget::changeEvent(QEvent *event)`.

[virtual protected] void QAbstractButton::checkStateSet()

Dieser virtuelle Handler wird aufgerufen, wenn ` setChecked()` verwendet wird, es sei denn, der Aufruf erfolgt innerhalb von ` nextCheckState()`. Er ermöglicht es Unterklassen, ihre Zwischenzustände der Schaltflächen zurückzusetzen.

Siehe auch ` nextCheckState()`.

[slot] void QAbstractButton::click()

Führt einen Klick aus.

Alle üblichen Signale, die mit einem Klick verbunden sind, werden entsprechend ausgegeben. Wenn die Schaltfläche aktivierbar ist, wird ihr Zustand umgeschaltet.

Diese Funktion führt keine Aktion aus, wenn die Schaltfläche disabled.

Siehe auch „ animateClick()“.

[signal] void QAbstractButton::clicked(bool checked = false)

Dieses Signal wird ausgelöst, wenn die Schaltfläche aktiviert wird (d. h. gedrückt und anschließend losgelassen wird, während sich der Mauszeiger innerhalb der Schaltfläche befindet), wenn die Tastenkombination eingegeben wird oder wenn ` click()` oder ` animateClick()` aufgerufen wird. Beachten Sie jedoch, dass dieses Signal nicht ausgelöst wird, wenn Sie ` setDown()`, ` setChecked()` oder ` toggle()` aufrufen.

Wenn die Schaltfläche aktivierbar ist, ist „ checked “ wahr, wenn die Schaltfläche aktiviert ist, und falsch, wenn sie deaktiviert ist.

Siehe auch „ pressed()“, „ released()“ und „ toggled()“.

[override virtual protected] bool QAbstractButton::event(QEvent *e)

Umsetzt: ` QWidget::event(QEvent *event)`.

[override virtual protected] void QAbstractButton::focusInEvent(QFocusEvent *e)

Implementiert: ` QWidget::focusInEvent(QFocusEvent *event)`.

[override virtual protected] void QAbstractButton::focusOutEvent(QFocusEvent *e)

Implementiert: ` QWidget::focusOutEvent(QFocusEvent *event)`.

QButtonGroup *QAbstractButton::group() const

Gibt die Gruppe zurück, zu der diese Schaltfläche gehört.

Wenn die Schaltfläche keinem „ QButtonGroup “ angehört, gibt diese Funktion „ nullptr “ zurück.

Siehe auch „ QButtonGroup “.

[virtual protected] bool QAbstractButton::hitButton(const QPoint &pos) const

Gibt „ true “ zurück, wenn sich „ pos “ innerhalb des klickbaren Rechtecks der Schaltfläche befindet; andernfalls wird „ false “ zurückgegeben.

Standardmäßig ist der anklickbare Bereich das gesamte Widget. Unterklassen können diese Funktion neu implementieren, um Unterstützung für anklickbare Bereiche unterschiedlicher Formen und Größen bereitzustellen.

[override virtual protected] void QAbstractButton::keyPressEvent(QKeyEvent *e)

Implementiert: QWidget::keyPressEvent(QKeyEvent *event).

[override virtual protected] void QAbstractButton::keyReleaseEvent(QKeyEvent *e)

Implementiert neu: ` QWidget::keyReleaseEvent(QKeyEvent *event)`.

[override virtual protected] void QAbstractButton::mouseMoveEvent(QMouseEvent *e)

Implementiert: ` QWidget::mouseMoveEvent` (`QMouseEvent *event`).

[override virtual protected] void QAbstractButton::mousePressEvent(QMouseEvent *e)

Implementiert: ` QWidget::mousePressEvent` (`QMouseEvent *event`).

[override virtual protected] void QAbstractButton::mouseReleaseEvent(QMouseEvent *e)

Implementiert: ` QWidget::mouseReleaseEvent(QMouseEvent *event)`.

[virtual protected] void QAbstractButton::nextCheckState()

Dieser virtuelle Handler wird aufgerufen, wenn auf eine Schaltfläche geklickt wird. Die Standardimplementierung ruft „ setChecked “ (! „isChecked “ ()) auf, wenn die Schaltfläche „ isCheckable “ () ist. Dies ermöglicht es Unterklassen, Zwischenzustände der Schaltfläche zu implementieren.

Siehe auch checkStateSet().

[override pure virtual protected] void QAbstractButton::paintEvent(QPaintEvent *e)

Umsetzt: ` QWidget::paintEvent` (`QPaintEvent *event`).

[signal] void QAbstractButton::pressed()

Dieses Signal wird ausgegeben, wenn die Taste gedrückt wird.

Siehe auch released() und clicked().

[signal] void QAbstractButton::released()

Dieses Signal wird ausgesendet, wenn die Taste losgelassen wird.

Siehe auch pressed(), clicked() und toggled().

[override virtual protected] void QAbstractButton::timerEvent(QTimerEvent *e)

Implementiert: ` QObject::timerEvent` (`QTimerEvent *event`).

[slot] void QAbstractButton::toggle()

Schaltet den Status einer aktivierbaren Schaltfläche um.

Siehe auch checked.

[signal] void QAbstractButton::toggled(bool checked)

Dieses Signal wird immer dann ausgelöst, wenn eine aktivierbare Schaltfläche ihren Zustand ändert. „ checked “ ist „true“, wenn die Schaltfläche aktiviert ist, und „false“, wenn sie deaktiviert ist.

Dies kann das Ergebnis einer Benutzeraktion, der Aktivierung des Slots „ click()“ oder des Aufrufs von „ setChecked()“ sein.

Die Zustände von Schaltflächen in exklusiven Schaltflächengruppen werden aktualisiert, bevor dieses Signal ausgesendet wird. Das bedeutet, dass Slots entweder auf das „off“-Signal oder das „on“-Signal reagieren können, das von den Schaltflächen in der Gruppe ausgesendet wird, deren Zustände sich geändert haben.

Beispielsweise lässt sich ein Slot, der auf Signale von neu aktivierten Schaltflächen reagiert, Signale von deaktivierten Schaltflächen jedoch ignoriert, mithilfe des folgenden Musters implementieren:

void MyWidget::reactToToggle(bool checked)
{
   if (checked) {
      // Examine the new button states.
      ...
   }
}

Schaltflächengruppen können mithilfe der Klasse „ QButtonGroup “ erstellt und Änderungen der Schaltflächenzustände mit dem Signal „ QButtonGroup::buttonClicked()“ überwacht werden.

Siehe auch „ checked “ und „ clicked()“.