QToolButton 是 Qt 框架中的一个类，是 QPushButton 的子类。它可以显示一个可单击的按钮，并且可以与弹出菜单、图标和文本等进行关联。

QToolButton的一些常见特性和用法包括：

1. 设置文本：使用 setText() 函数设置按钮上的文本。
2. 设置图标：使用 setIcon() 函数设置按钮上的图标。可以使用资源文件中的图标，也可以使用本地文件路径或URL。
3. 设置弹出菜单：使用 setMenu() 函数设置按钮的弹出菜单。可以通过创建 QMenu 对象并将其添加到按钮上。
4. 设置工具提示：使用 setToolTip() 函数设置按钮的工具提示，鼠标悬停在按钮上时显示的文本。
5. 设置按钮样式：使用 setToolButtonStyle() 函数设置按钮的图标和文本的位置关系。例如，可以设置为 Qt::ToolButtonTextBesideIcon 或 Qt::ToolButtonTextUnderIcon。
6. 连接信号和槽：使用信号 clicked() 来捕获按钮的点击事件，并将其与槽函数连接起来。
7. 设置按钮是否可用：使用 setEnabled() 函数设置按钮是否可用，以便根据需要启用或禁用按钮。

除了上述特性外，还有其他一些函数可用于调整按钮的外观和行为，例如设置按钮的尺寸、设置按钮的样式表等。

QToolButton 提供了一种灵活的方法来创建可自定义的工具按钮，可以在工具栏、菜单栏、对话框等界面元素中使用。可以根据项目的需求自由地使用和定制。

下面是一个QToolButton的示例，展示了常用的一些功能：

#include <QApplication>
#include <QToolButton>
#include <QMessageBox>
#include <QMenu>
#include <QWidget>
#include <QVBoxLayout>int main(int argc, char* argv[])
{QApplication app(argc, argv);QWidget w;w.setFixedSize(600, 400);QVBoxLayout layout;w.setLayout(&layout);QToolButton toolButton;toolButton.setFixedSize(150, 30);layout.addWidget(&toolButton);toolButton.setText("ToolButton");toolButton.setToolTip("This is a tool button");// 设置图标和文本的位置关系toolButton.setToolButtonStyle(Qt::ToolButtonTextBesideIcon);toolButton.setPopupMode(QToolButton::MenuButtonPopup);// 设置图标QIcon icon("./icon.png");toolButton.setIcon(icon);// 设置弹出菜单QMenu* menu = new QMenu(&toolButton);menu->addAction("Action 1");menu->addAction("Action 2");menu->setFixedWidth(toolButton.width());toolButton.setMenu(menu);// 连接点击信号与槽函数QObject::connect(&toolButton, &QToolButton::clicked, [&]() {//QMessageBox::information(nullptr, "Clicked", "ToolButton clicked!");toolButton.showMenu();});// 显示 ToolButtonw.show();return app.exec();
}

上述代码使用QWidget作为主窗口，布局为垂直布局，垂直布局中放入了一个QToolButton的对象。该QToolButton对象设置了如下内容：

• 设置图标和文本的位置关系
• 设置图标
• 设置弹出菜单
• 设置弹出菜单

运行结果截图：