【Qt开发】Qt窗口（二） -＞ QToolBar工具栏

文章目录

[1 -> 概述](#1 -> 概述)
[2 -> 核心特性](#2 -> 核心特性)
- [2.1 -> 灵活的可停靠性](#2.1 -> 灵活的可停靠性)
- [2.2 -> 丰富的内容支持](#2.2 -> 丰富的内容支持)
- [2.3 -> 智能的尺寸适应](#2.3 -> 智能的尺寸适应)
- [2.4 -> 上下文感知](#2.4 -> 上下文感知)
[3 -> 工具栏的设计原则](#3 -> 工具栏的设计原则)
- [3.1 -> 一致性原则](#3.1 -> 一致性原则)
- [3.2 -> 组织逻辑性](#3.2 -> 组织逻辑性)
- [3.3 -> 适度性原则](#3.3 -> 适度性原则)
- [3.4 -> 可定制性考虑](#3.4 -> 可定制性考虑)
[4 -> 创建工具栏](#4 -> 创建工具栏)
[5 -> 设置停靠位置](#5 -> 设置停靠位置)
[6 -> 设置浮动属性](#6 -> 设置浮动属性)
[7 -> 设置移动属性](#7 -> 设置移动属性)
[8 -> 综合示例](#8 -> 综合示例)
[9 -> 总结](#9 -> 总结)

1 -> 概述

在现代化的图形用户界面开发中，工具栏作为用户与应用程序交互的重要桥梁，扮演着不可或缺的角色。Qt框架中的QToolBar类提供了一个强大而灵活的工具栏解决方案，它不仅仅是简单的一排按钮集合，更是一个高度可定制、功能丰富的界面组件。工具栏的设计质量直接影响着用户的操作效率和整体体验，一个精心设计的工具栏能够显著提升应用程序的专业性和易用性。

QToolBar继承自QWidget，这意味着它拥有所有标准窗口部件的特性，同时又被专门优化用于工具栏的特定需求。它能够无缝集成到Qt的主窗口架构中，与菜单栏、状态栏等其他界面元素协同工作，共同构建出协调统一的用户界面。

2 -> 核心特性

2.1 -> 灵活的可停靠性

QToolBar最显著的特性之一是其卓越的可停靠性设计。用户可以根据个人偏好和工作习惯，将工具栏停靠在主窗口的四个边界中的任何一个，或者将其拖拽出来成为独立的浮动窗口。这种灵活性不仅增强了用户体验，还适应了不同工作场景的需求。当工具栏处于浮动状态时，它会自动转换为一个独立的顶层窗口，拥有自己的标题栏和关闭按钮，同时保持所有的功能完整性。

2.2 -> 丰富的内容支持

虽然工具栏最常见的内容是动作按钮，但QToolBar的功能远不止于此。它可以容纳多种类型的界面元素：

动作按钮：通过QAction对象创建，支持文本、图标、工具提示等

分隔符：用于逻辑分组相关功能，提高视觉清晰度

自定义部件：可以插入任何QWidget派生类的实例，如组合框、搜索框、进度条等

弹簧空间：用于在工具栏内创建弹性空间，实现元素的对齐和分布控制

这种多样性使得开发者能够根据具体需求创建出功能丰富、布局合理的工具栏界面。

2.3 -> 智能的尺寸适应

QToolBar具备智能的尺寸适应能力，能够根据可用空间自动调整其内容的显示方式。当空间充足时，工具栏可以同时显示图标和文本标签；当空间受限时，它可以自动切换到只显示图标或只显示文本的模式。这种自适应性确保了在不同窗口尺寸和显示分辨率下都能保持良好的可用性。

2.4 -> 上下文感知

高级的工具栏实现可以具备上下文感知能力，根据当前的操作状态或选中的内容动态调整可用功能。这种智能化的行为显著提升了用户体验，避免了用户在不恰当的上下文中看到不可用的功能选项。

3 -> 工具栏的设计原则

3.1 -> 一致性原则

工具栏设计应保持内部和外部的一致性。内部一致性要求工具栏内的图标风格、尺寸、间距等视觉元素保持统一；外部一致性则要求工具栏与应用程序的其他部分以及操作系统平台的设计规范保持一致。这种一致性减少了用户的学习成本，提高了界面的可预测性。

3.2 -> 组织逻辑性

功能相关的工具应该被分组放置，组与组之间使用视觉分隔符进行区分。分组的逻辑应该基于用户的任务流程和心智模型，而不是开发者的技术架构。常用的功能应该具有更突出的位置，而不常用的功能可以放置在次要位置或通过扩展机制访问。

3.3 -> 适度性原则

工具栏不应该成为所有功能的倾倒场。过度拥挤的工具栏会降低查找效率，增加用户的认知负荷。应该仔细权衡每个功能的重要性，只将最常用、最关键的功能放置在主工具栏中，其他功能可以通过上下文菜单、菜单栏或面板等方式访问。

3.4 -> 可定制性考虑

考虑到不同用户有不同的工作习惯和偏好，提供一定程度的工具栏自定义能力是很有价值的。允许用户重新排列工具位置、显示/隐藏特定工具、创建自定义工具栏等，能够显著提升用户的控制感和满意度。

4 -> 创建工具栏

调用 QMainWindow类 的 addToolBar() 函数来创建工具栏，每增加一个工具栏都需要调用一次该函数。

cpp 复制代码

// 创建工具栏
QToolBar* toolBar = new QToolBar();
this->addToolBar(toolBar);

5 -> 设置停靠位置

⼯具栏停靠位置的设置有两种方式。⼀种是在创建⼯具栏的同时指定停靠的位置，另⼀种是通过
QToolBar类 提供的 setAllowedAreas()函数 来设置。

方式⼀：创建工具栏的同时指定其停靠的位置。

在创建工具栏的同时，也可以设置工具栏的位置，其默认位置是在窗口的最上面；如上述代码，默认

在最上面显示。工具栏允许停靠的区域由 QToolBar类 提供的 allowAreas()函数 决定，其中可以设置

的位置包括：

Qt::LeftToolBarArea 停靠在左侧
Qt::RightToolBarArea 停靠在右侧
Qt::TopToolBarArea 停靠在顶部
Qt::BottomToolBarArea 停靠在底部
Qt::AllToolBarAreas 以上四个位置都可停靠

cpp 复制代码

QToolBar* toolBar1 = new QToolBar();
QToolBar* toolBar2 = new QToolBar();
this->addToolBar(toolBar1);
// 设置默认位置
this->addToolBar(Qt::RightToolBarArea,toolBar2);

方式二：使用 QToolBar类提供的 setAllowedAreas()函数设置停靠位置

cpp 复制代码

QToolBar* toolBar1 = new QToolBar();
QToolBar* toolBar2 = new QToolBar();
this->addToolBar(toolBar1);
// 设置默认位置
this->addToolBar(Qt::RightToolBarArea, toolBar2);

// 只允许停靠左边或右边
toolBar2->setAllowedAreas(Qt::LeftToolBarArea | Qt::RightToolBarArea);

说明：
在创建工具栏的同时指定其停靠的位置，指的是程序运行时工具栏默认所在的位置；而使用
setAllowedAreas()函数设置停靠位置，指的是工具栏允许其所能停靠的位置。

6 -> 设置浮动属性

工具栏的浮动属性可以通过 QToolBar类 提供的 setFloatable()函数 来设置。setFloatable()函数原型为：

void setFloatable(bool floatable)

cpp 复制代码

QToolBar* toolBar1 = new QToolBar();
QToolBar* toolBar2 = new QToolBar();
this->addToolBar(toolBar1);
// 设置默认位置
this->addToolBar(Qt::RightToolBarArea, toolBar2);

// 只允许停靠左边或右边
toolBar2->setAllowedAreas(Qt::LeftToolBarArea | Qt::RightToolBarArea);

// 不允许浮动
toolBar2->setFloatable(false);

7 -> 设置移动属性

设置工具栏的移动属性可以通过 QToolBar类 提供的 setMovable()函数 来设置。setMovable()函数原型为：

void setMovable(bool movable)

说明：
若设置工具栏为不移动状态，则设置其停靠位置的操作就不会生效，所以设置工具栏的移动属性类似于总开关的效果。

cpp 复制代码

QToolBar* toolBar1 = new QToolBar();
QToolBar* toolBar2 = new QToolBar();
this->addToolBar(toolBar1);
// 设置默认位置
this->addToolBar(Qt::RightToolBarArea, toolBar2);

// 只允许停靠左边或右边
toolBar2->setAllowedAreas(Qt::LeftToolBarArea | Qt::RightToolBarArea);

// 不允许浮动
toolBar2->setFloatable(false);

// 不允许移动
toolBar2->setMovable(false);

8 -> 综合示例

cpp 复制代码

#include "mainwindow.h"
#include "ui_mainwindow.h"

#include <QToolBar>

MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);

QToolBar* toolBar1 = new QToolBar();
QToolBar* toolBar2 = new QToolBar();
this->addToolBar(toolBar1);
// 设置默认位置
this->addToolBar(Qt::RightToolBarArea, toolBar2);

// 只允许停靠左边或右边
toolBar2->setAllowedAreas(Qt::LeftToolBarArea | Qt::RightToolBarArea);

// 不允许浮动
toolBar2->setFloatable(false);

// 不允许移动
toolBar2->setMovable(false);

QAction* action1 = new QAction("动作1");
QAction* action2 = new QAction("动作2");
QAction* action3 = new QAction("动作3");
QAction* action4 = new QAction("动作4");

toolBar1->addAction(action1);
toolBar1->addAction(action2);
toolBar2->addAction(action3);
toolBar2->addAction(action4);

}

MainWindow::~MainWindow()
{
	delete ui;
}

9 -> 总结

QToolBar作为Qt框架中一个成熟而强大的工具栏解决方案，为开发者提供了创建专业级用户界面所需的全部工具。通过其灵活的可停靠性、丰富的内容支持、智能的尺寸适应和上下文感知能力，QToolBar能够满足各种复杂应用程序的需求。

成功的工具栏设计不仅仅是技术的实现，更是对用户需求、工作流程和认知心理的深刻理解。它需要在功能丰富性和界面简洁性之间找到平衡，在一致性和灵活性之间做出权衡，在标准化和个性化之间寻求和谐。

随着用户界面设计理念的不断演进，工具栏的角色和形态也在不断发展。从传统的静态工具栏到现代的上下文感知、自适应工具栏，这一界面元素继续在提高用户生产力和操作效率方面发挥着关键作用。掌握QToolBar的有效使用和工具栏的设计原则，对于创建出色的Qt应用程序具有重要意义。

最终，一个优秀的工具栏应该做到"存在但不突兀，强大但不复杂"，它应该成为用户完成任务的得力助手，而不是需要克服的障碍。通过精心设计和实现，工具栏能够显著提升应用程序的整体质量和用户体验。

感谢各位大佬支持！！！

互三啦！！！