【Qt控件之QToolButton】概述及示例

最新推荐文章于 2026-05-01 22:37:28 发布

原创

最新推荐文章于 2026-05-01 22:37:28 发布 · 1.9k 阅读

标签

#qt #开发语言

本文详细介绍了Qt框架中的QToolButton类，包括其创建方式、特点（如无文本标签、自动凸起、弹出菜单等）、常用函数和信号槽机制。通过实例展示了如何使用QToolButton和连接信号槽处理点击事件。

简介

QToolButton 类提供了一个快速访问命令或选项的按钮，通常在 QToolBar 内部使用。

工具按钮是一种特殊的按钮，用于快速访问特定的命令或选项。与普通的命令按钮相反，工具按钮通常不显示文本标签，而是显示一个图标。

通常情况下，工具按钮是通过使用 QToolBar::addAction() 创建新的 QAction 实例或将现有的操作添加到工具栏的方式来创建的。还可以像创建任何其他小部件一样构造工具按钮，并将它们与其他小部件一起布局排列。

工具按钮的一个经典用途是选择工具；例如，绘图程序中的 “画笔” 工具。这可以通过使用 QToolButton 作为切换按钮（参见 setToggleButton()）来实现。

QToolButton 支持自动凸起。在自动凸起模式下，只有当鼠标指向按钮时，按钮才会绘制 3D 边框。当按钮在 QToolBar 内部使用时，该功能会自动开启。可以使用 setAutoRaise() 方法进行更改。

工具按钮的图标是使用 QIcon 设置的。这样可以为禁用状态和活动状态指定不同的像素图。禁用的像素图在按钮的功能不可用时使用。当鼠标悬停在按钮上时，活动的像素图将显示出来，因为按钮会自动凸起。

可以使用 setToolButtonStyle() 和 setIconSize() 调整按钮的外观和尺寸。当在 QMainWindow 中的 QToolBar 中使用时，按钮会自动调整为 QMainWindow 的设置（参见 QMainWindow::setToolButtonStyle() 和 QMainWindow::setIconSize()）。工具按钮还可以显示一个箭头符号，可以使用 arrowType 指定。

工具按钮可以在弹出菜单中提供额外的选择。可以使用 setMenu() 设置弹出菜单。使用 setPopupMode() 来配置具有菜单设置的工具按钮的不同模式。默认模式是 DelayedPopupMode，该模式通常与 Web浏览器中的 “返回” 按钮一起使用。按住按钮一段时间后，会弹出一个菜单，显示要跳转到的可能页面列表。默认的延迟时间是 600 毫秒，可以使用 setPopupDelay() 进行调整。
在这里插入图片描述

常用函数

QToolButton 是 Qt 框架提供的一个工具按钮控件，用于在用户界面中提供快捷访问命令或选项的按钮。
以下是关于 QToolButton 的构造函数、枚举、常用函数、信号和槽的介绍：

构造函数：
- QToolButton(QWidget *parent = nullptr)：使用指定的父窗口创建一个默认的 QToolButton 实例。
- QToolButton(const QString &text, QWidget *parent = nullptr)：使用指定的文本和父窗口创建一个 QToolButton 实例。
枚举：