QAbstractButton Class

  QPushButton *button = new QPushButton(tr("Ro&ck && Roll"), this);

  button->setIcon(QIcon(":/images/print.png"));
  button->setShortcut(tr("Alt+F7"));

成员函数

QAbstractButton::QAbstractButton(QWidget *parent = Q_NULLPTR)

构造函数.

参数 parent 父对象.

QAbstractButton::~QAbstractButton()

析构函数.

[slot] void QAbstractButton::animateClick(int msec = 100)

点击事件的执行过程: 按钮被立即按下, msec 后释放 (默认是 100 ms).

按钮释放之前调用这个函数重置释放时间.

所有与点击相关的信号被适时发送.

如果禁用按钮 , 该函数不执行任何操作.

参见 click().

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

重新实现 QWidget::changeEvent().

[virtual protected] void QAbstractButton::checkStateSet()

如果不是从nextCheckState()内部调用 setChecked() 函数, Qt会调用该函数. 它允许派生类重置它们的中间按钮状态.

参见 nextCheckState().

[slot] void QAbstractButton::click()

执行点击动作.

所有与点击相关的信号被适时发送. 如果按钮是可选中的, 更改选中状态.

如果禁用按钮 , 该函数不执行任何操作.

参见 animateClick().

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

信号触发情况: 光标在按钮内,按下再释放按钮; 按下快捷键; 调用click(); 调用 animateClick(). 通常情况下, 你调用 setDown(), setChecked() 或 toggle(), 不会发送这个信号.

按钮是可选中的, 按钮被选中时, checked 是 true, 否则是 false .

参见 pressed(), released() 和 toggled().

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

重新实现 QObject::event().

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

重新实现 QWidget::focusInEvent().

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

重新实现 QWidget::focusOutEvent().

QButtonGroup *QAbstractButton::group() const

返回按钮归属的组.

如果按钮不属于任何 QButtonGroup, 这个函数返回 0.

参见 QButtonGroup.

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

true 表示 pos 在按钮的可点击矩形区内; 否则返回 false.

默认情况下, 可点击区域是整个按钮. 子类中重新实现这个函数实现自定义点击区域的形状和大小.

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

重新实现 QWidget::keyPressEvent().

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

重新实现 QWidget::keyReleaseEvent().

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

重新实现 QWidget::mouseMoveEvent().

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

重新实现 QWidget::mousePressEvent().

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

重新实现 QWidget::mouseReleaseEvent().

[virtual protected] void QAbstractButton::nextCheckState()

按钮被点击时, 调用这个函数. 如果按钮是可选中的isCheckable(), 默认实现是调用 setChecked(!isChecked()). 派生类可以重新实现这个函数定义立即按钮状态.

参见 checkStateSet().

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

重新实现 QWidget::paintEvent().

[signal] void QAbstractButton::pressed()

按钮按下时发送这个信号.

参见 released() 和 clicked().

[signal] void QAbstractButton::released()

按钮释放时发送这个信号.

参见 pressed(), clicked() 和 toggled().

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

重新实现 QObject::timerEvent().

[slot] void QAbstractButton::toggle()

改变按钮的可选中状态.

参见 checked.

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

按钮的可选中状态改变时发送这个信号. 如果按钮被选中, checked 是 true, 否则 false.

这个可能由一个用户动作产生, 调用 click() 或者调用 setChecked() .

信号发送之前, Qt会更新独占性分组中的按钮状态. 这就意味着槽函数可以判断按钮的选中状态.

槽函数可以使用如下示例的模式, 仅处理按钮的选中状态信号, 忽略未选中状态信号:

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

按钮分组使用 QButtonGroup 创建, 改变分组中按钮的状态会发送信号 QButtonGroup::buttonClicked().

注意: 这是checked的通知信号.

参见 checked and clicked().