QToolButton Class

成员函数文档

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

创建一个父级为parent 的空工具按钮。

[virtual noexcept] QToolButton::~QToolButton()

销毁该对象并释放所有已分配的资源。

[override virtual protected] void QToolButton::actionEvent(QActionEvent *event)

重写了：QWidget::actionEvent(QActionEvent *event)。

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

重写了：QAbstractButton::changeEvent(QEvent *e)。

[override virtual protected] void QToolButton::checkStateSet()

重写了：QAbstractButton::checkStateSet()。

QAction *QToolButton::defaultAction() const

返回默认操作。

另请参阅 setDefaultAction()。

[override virtual protected] void QToolButton::enterEvent(QEnterEvent *e)

重写了：QWidget::enterEvent(QEnterEvent *event)。

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

重写了：QAbstractButton::event(QEvent *e)。

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

重写了：QAbstractButton::hitButton(const QPoint &pos) const。

[virtual protected] void QToolButton::initStyleOption(QStyleOptionToolButton *option) const

使用QToolButton 中的值初始化option 。当子类需要一个QStyleOptionToolButton ，但又不想自己填写所有信息时，此方法非常有用。

另请参阅 QStyleOption::initFrom()。

[override virtual protected] void QToolButton::leaveEvent(QEvent *e)

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

QMenu *QToolButton::menu() const

返回关联的菜单；如果未定义任何菜单，则返回nullptr 。

另请参阅 setMenu()。

[override virtual] QSize QToolButton::minimumSizeHint() const

重新实现了属性QWidget::minimumSizeHint 的访问函数。

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

重写了：QAbstractButton::mousePressEvent(QMouseEvent *e)。

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

重写了：QAbstractButton::mouseReleaseEvent(QMouseEvent *e)。

[override virtual protected] void QToolButton::nextCheckState()

重写了：QAbstractButton::nextCheckState()。

[override virtual protected] void QToolButton::paintEvent(QPaintEvent *event)

重写：QAbstractButton::paintEvent(QPaintEvent *e)。

响应绘制事件event 时，对按钮进行绘制。

[slot] void QToolButton::setDefaultAction(QAction *action)

将默认操作设置为action 。

如果工具按钮具有默认操作，则该操作将定义按钮的以下属性：

• checkable
• checked
• enabled
• font
• icon
• popupMode （假设该操作带有菜单）
• statusTip
• text
• toolTip
• whatsThis

其他属性（例如 `autoRepeat`）不受操作的影响。

另请参阅 defaultAction()。

void QToolButton::setMenu(QMenu *menu)

将给定的menu 与该工具按钮关联起来。

菜单将根据按钮的popupMode 显示。

菜单的所有权不会转移给该工具按钮。

另请参阅 menu()。

[slot] void QToolButton::showMenu()

显示（弹出）相应的弹出菜单。如果不存在此类菜单，则该函数不执行任何操作。在用户关闭弹出菜单之前，该函数不会返回。

[override virtual] QSize QToolButton::sizeHint() const

重新实现了属性QWidget::sizeHint 的访问函数。

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

重写了：QAbstractButton::timerEvent(QTimerEvent *e)。

[signal] void QToolButton::triggered(QAction *action)

当指定的action 被触发时，会发出此信号。

该操作还可以与用户界面的其他部分相关联，例如菜单项和键盘快捷键。通过这种方式共享操作有助于提高用户界面的统一性，且通常更易于实现。