QAbstractButton 类

成员函数文档

[显式] QAbstractButton::QAbstractButton(QWidget *parent = nullptr)

构造一个具有父的抽象按钮。

[虚无异常] QAbstractButton::~QAbstractButton()

销毁按钮。

[槽] void QAbstractButton::animateClick()

执行动画点击：按钮立即按下，并在100ms后释放。

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

根据适当的情况发出所有与点击相关的信号。

如果按钮禁用。则此函数不执行任何操作。

另请参阅click。

[重写虚保护] void QAbstractButton::changeEvent(QEvent *e)

重新实现：QWidget::changeEvent(QEvent *event)。

[虚保护] void QAbstractButton::checkStateSet()

此虚拟处理程序在调用setChecked()时调用，除非它从nextCheckState内部调用。它允许子类重置它们的中间按钮状态。

另请参阅nextCheckState。

[槽] void QAbstractButton::click()

执行点击。

根据适当的情况发出所有与点击相关的常规信号。如果按钮是可复选的，则切换按钮的状态。

如果按钮禁用。则此函数不执行任何操作。

另请参阅 animateClick()。

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

当按钮被激活（即按住然后在鼠标光标在按钮内部释放）时，当用户按下快捷键，或者当调用 click() 或 animateClick() 时，将发出此信号。值得注意的是，调用 setDown()、setChecked() 或 toggle() 时，不会发出此信号。

如果按钮可勾选，则 checked 为真表示按钮已被勾选，或为假表示按钮未被勾选。

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

[虚继承受保护] bool QAbstractButton::event(QEvent *e)

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

[虚继承受保护] void QAbstractButton::focusInEvent(QFocusEvent *e)

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

[虚继承受保护] void QAbstractButton::focusOutEvent(QFocusEvent *e)

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

QButtonGroup *QAbstractButton::group() const

返回此按钮所属的组。

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

另请参阅 QButtonGroup。

[虚受保护] bool QAbstractButton::hitButton(const QPoint &pos) const

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

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

[虚继承受保护] void QAbstractButton::keyPressEvent(QKeyEvent *e)

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

[虚继承受保护] void QAbstractButton::keyReleaseEvent(QKeyEvent *e)

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

[虚继承受保护] void QAbstractButton::mouseMoveEvent(QMouseEvent *e)

重实现：QWidget::mouseMoveEvent(QMouseEvent *event).

[重载虚拟保护] void QAbstractButton::mousePressEvent(QMouseEvent *e)

重实现：QWidget::mousePressEvent(QMouseEvent *event).

[重载虚拟保护] void QAbstractButton::mouseReleaseEvent(QMouseEvent *e)

重实现：QWidget::mouseReleaseEvent(QMouseEvent *event).

[虚拟保护] void QAbstractButton::nextCheckState()

此虚拟处理器是在按钮被点击时调用的。默认实现如果按钮是可复选的，则调用 setChecked(!isChecked())。这允许子类实现按钮的中间状态。

请参阅 checkStateSet().

[重载虚拟保护] void QAbstractButton::paintEvent(QPaintEvent *e)

重实现：QWidget::paintEvent(QPaintEvent *event).

[信号] void QAbstractButton::pressed()

当按钮被按下时发出此信号。

请参阅 released() 和 clicked().

[信号] void QAbstractButton::released()

当按钮被释放时发出此信号。

请参阅 pressed()，clicked() 和 toggled().

[重载虚拟保护] void QAbstractButton::timerEvent(QTimerEvent *e)

重实现：QObject::timerEvent(QTimerEvent *event).

[槽] void QAbstractButton::toggle()

切换可复选按钮的状态。

另请参阅 checked。

[信号] 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。