QAbstractButton Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine abstrakte Schaltfläche mit einer parent.

[virtual noexcept] QAbstractButton::~QAbstractButton()

Zerstört 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.

Ein erneuter Aufruf dieser Funktion vor dem Loslassen der Taste setzt den Timer für das Loslassen zurück.

Alle mit einem Klick verbundenen Signale werden entsprechend ausgegeben.

Diese Funktion tut nichts, wenn die Taste gedrückt wird. disabled.

Siehe auch click().

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

Reimplements: QWidget::changeEvent(QEvent *Event).

[virtual protected] void QAbstractButton::checkStateSet()

Dieser virtuelle Handler wird aufgerufen, wenn setChecked() verwendet wird, es sei denn, er wird innerhalb von nextCheckState() aufgerufen. Er ermöglicht es Unterklassen, ihre Schaltflächen-Zwischenstände 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 überprüfbar ist, wird der Zustand der Schaltfläche umgeschaltet.

Diese Funktion tut nichts, wenn die Schaltfläche disabled.

Siehe auch animateClick().

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

Dieses Signal wird ausgegeben, wenn die Schaltfläche aktiviert wird (d. h., wenn sie gedrückt und dann losgelassen wird, während sich der Mauszeiger auf der Schaltfläche befindet), wenn die Tastenkombination eingegeben wird oder wenn click() oder animateClick() aufgerufen wird. Insbesondere wird dieses Signal nicht ausgegeben, wenn Sie setDown(), setChecked() oder toggle() aufrufen.

Wenn die Schaltfläche abhakbar ist, ist checked wahr, wenn die Schaltfläche abgehakt ist, oder falsch, wenn die Schaltfläche nicht abgehakt ist.

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

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

Reimplements: QWidget::event(QEvent *Event).

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

Reimplements: QWidget::focusInEvent(QFocusEvent *event).

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

Reimplements: QWidget::focusOutEvent(QFocusEvent *event).

QButtonGroup *QAbstractButton::group() const

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

Wenn die Schaltfläche zu keiner Gruppe QButtonGroup gehört, gibt diese Funktion nullptr zurück.

Siehe auch QButtonGroup.

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

Gibt true zurück, wenn pos innerhalb des Rechtecks der anklickbaren Schaltfläche liegt; 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 zu bieten.

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

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

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

Reimplements: QWidget::keyReleaseEvent(QKeyEvent *event).

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

Reimplements: QWidget::mouseMoveEvent(QMouseEvent *event).

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

Reimplements: QWidget::mousePressEvent(QMouseEvent *event).

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

Reimplements: QWidget::mouseReleaseEvent(QMouseEvent *event).

[virtual protected] void QAbstractButton::nextCheckState()

Dieser virtuelle Handler wird aufgerufen, wenn eine Schaltfläche angeklickt wird. Die Standardimplementierung ruft setChecked(!isChecked()) auf, wenn die Schaltfläche isCheckable(). Sie erlaubt es Unterklassen, Zwischenzustände von Schaltflächen zu implementieren.

Siehe auch checkStateSet().

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

Reimplements: QWidget::paintEvent(QPaintEvent *event).

[signal] void QAbstractButton::pressed()

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

Siehe auch released() und clicked().

[signal] void QAbstractButton::released()

Dieses Signal wird ausgegeben, wenn die Taste losgelassen wird.

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

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

Reimplements: QObject::timerEvent(QTimerEvent *event).

[slot] void QAbstractButton::toggle()

Schaltet den Zustand einer ankreuzbaren Schaltfläche um.

Siehe auch checked.

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

Dieses Signal wird immer dann ausgegeben, wenn eine ankreuzbare Schaltfläche ihren Zustand ändert. checked ist true, wenn die Schaltfläche angekreuzt ist, oder false, wenn die Schaltfläche nicht angekreuzt 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 ausgegeben wird. Das bedeutet, dass Slots entweder auf das "Aus"-Signal oder auf das "Ein"-Signal reagieren können, das von den Schaltflächen in der Gruppe, deren Zustand sich geändert hat, ausgegeben wird.

Ein Slot, der auf Signale reagiert, die von neu markierten Schaltflächen ausgesendet werden, der aber Signale von nicht markierten Schaltflächen ignoriert, kann beispielsweise nach folgendem Muster implementiert werden:

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

Schaltflächengruppen können mit der Klasse QButtonGroup erstellt werden, und Aktualisierungen der Schaltflächenzustände werden mit dem Signal QButtonGroup::buttonClicked() überwacht.

Siehe auch checked und clicked().