QAbstractButton Class

成员函数文档

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

创建一个带有parent 的抽象按钮。

[virtual noexcept] QAbstractButton::~QAbstractButton()

销毁该按钮。

[slot] void QAbstractButton::animateClick()

执行一次动画点击：按钮立即被按下，并在100毫秒后松开。

在按钮释放之前再次调用此函数将重置释放计时器。

与点击相关的所有信号都会在适当的时候触发。

如果按钮处于disabled.

另请参阅 click()。

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

重写了：QWidget::changeEvent(QEvent *event)。

[virtual protected] void QAbstractButton::checkStateSet()

当调用setChecked()时，会调用此虚拟处理程序，除非该调用是在nextCheckState()内部进行的。它允许子类重置其按钮的中间状态。

另请参阅 nextCheckState()。

[slot] void QAbstractButton::click()

执行一次点击操作。

将根据需要发出与单击相关的所有常规信号。如果该按钮是可选中的，则切换按钮的状态。

如果按钮为disabled.

另请参阅 animateClick()。

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

当按钮被激活（即鼠标光标位于按钮内部时按下并松开按钮）、输入快捷键，或者调用click()或animateClick()时，会发出此信号。需要注意的是，如果调用setDown()、setChecked()或toggle()，则不会发出此信号。

如果按钮支持复选，当按钮被选中时，checked 为 true；未被选中时，则为 false。

另请参阅 pressed()、released() 和toggled()。

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

重写了：QWidget::event(QEvent *event)。

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

重写了：QWidget::focusInEvent(QFocusEvent *event)。

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

重写了：QWidget::focusOutEvent(QFocusEvent *event)。

QButtonGroup *QAbstractButton::group() const

返回该按钮所属的组。

如果该按钮不属于任何QButtonGroup ，则此函数返回nullptr 。

另请参阅 QButtonGroup 。

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

如果 `pos ` 位于可点击按钮矩形内部，则返回 `true `；否则返回 `false`。

默认情况下，可点击区域为整个小部件。子类可以重写此函数，以支持不同形状和大小的可点击区域。

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

重写了：QWidget::keyPressEvent(QKeyEvent *event)。

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

重写了：QWidget::keyReleaseEvent(QKeyEvent *event)。

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

重写了：QWidget::mouseMoveEvent(QMouseEvent *event)。

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

重写了：QWidget::mousePressEvent(QMouseEvent *event)。

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

重写了：QWidget::mouseReleaseEvent(QMouseEvent *event)。

[virtual protected] void QAbstractButton::nextCheckState()

当按钮被点击时，会调用此虚拟处理程序。如果按钮处于isCheckable()状态，则默认实现会调用setChecked(!isChecked())。这允许子类实现按钮的中间状态。

另请参阅 checkStateSet()。

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

重写了：QWidget::paintEvent(QPaintEvent *event)。

[signal] void QAbstractButton::pressed()

按下按钮时会发出此信号。

另请参阅 released() 和clicked()。

[signal] void QAbstractButton::released()

松开按钮时会发出此信号。

另请参阅 pressed()、clicked()、以及toggled()。

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

重写了：QObject::timerEvent(QTimerEvent *event)。

[slot] void QAbstractButton::toggle()

切换可选中按钮的状态。

另请参阅 checked 。

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

每当一个可选中按钮的状态发生变化时，都会触发此信号。如果按钮被选中，checked 为 true；如果按钮未被选中，则为 false。

这可能是用户操作、click() 槽激活，或者因为调用了setChecked() 的结果。

在发出此信号之前，互斥按钮组中按钮的状态会先被更新。这意味着，槽函数可以响应该组中状态发生变化的按钮发出的“off”信号或“on”信号。

例如，可以使用以下模式实现一个槽：该槽对新被选中的按钮发出的信号做出反应，但忽略来自已取消选中按钮的信号：

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

可以使用QButtonGroup 类创建按钮组，并通过QButtonGroup::buttonClicked()信号监听按钮状态的更新。

另请参阅 checked 和clicked()。