【Qt】QToolBar、QToolButton的常用用法

一、QToolBar 常用用法

QToolBar 是 Qt 中用于创建工具栏的控件，可快速放置常用功能按钮、分隔符或自定义控件，并支持拖动停靠、浮动等特性。

1. 基础创建与添加到主窗口

// 在 QMainWindow 中创建工具栏
QToolBar *toolBar = new QToolBar(tr("主工具栏"), this);
addToolBar(toolBar); // 将工具栏添加到主窗口（默认停靠在顶部）

2. 添加动作（QAction）与控件

工具栏的核心元素是 QAction（可同时用于菜单和工具栏），也可直接添加自定义控件（如 QComboBox、QLineEdit）。

// 示例：添加“新建”“打开”动作 + 搜索框
QAction *actionNew = new QAction(tr("&New"), this);
QAction *actionOpen = new QAction(tr("&Open"), this);
toolBar->addAction(actionNew);   // 添加动作
toolBar->addAction(actionOpen);
toolBar->addSeparator();         // 添加分隔符

QLineEdit *searchBox = new QLineEdit();
searchBox->setPlaceholderText("搜索...");
toolBar->addWidget(searchBox);   // 添加自定义控件

3. 停靠与浮动控制

工具栏支持拖动到窗口的上、下、左、右区域，或脱离成为浮动窗口。

toolBar->setMovable(true);       // 允许拖动（默认 true）
toolBar->setFloatable(true);     // 允许浮动（默认 true）
toolBar->setAllowedAreas(Qt::TopToolBarArea | Qt::BottomToolBarArea)