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()

除非在nextCheckState() 中调用，否则在使用setChecked() 时会调用此虚拟处理程序。它允许子类重置中间按钮状态。

另请参见 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() 的结果。

专属按钮组中按钮的状态会在该信号发出前更新。这意味着插槽既可以根据 "关闭 "信号采取行动，也可以根据状态发生变化的按钮组发出的 "打开 "信号采取行动。

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

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

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

另请参阅 checked 和clicked()。