Qt窗口 | 工具栏 | QToolBar的使用及说明

Qt窗口 | 工具栏 | QToolBar的使用及说明

引用

CSDN

1.

https://blog.csdn.net/m0_74014525/article/details/139119244

Qt窗口 | 工具栏 | QToolBar的使用及说明

一、工具栏

1. 什么是工具栏

工具栏是一种位于软件或应用程序界面上方的水平栏，通常包含一系列常用工具和命令按钮，用于快速访问和执行常用功能。工具栏通常通过图标、文本或图标加文本的形式展示工具和命令，用户可以通过单击这些按钮来执行相应的操作，从而提高工作效率。工具栏可以根据用户的需求进行自定义，或者根据软件的功能进行预设，以满足不同用户的操作习惯和工作需求。常见的工具栏包括格式工具栏、编辑工具栏、插入工具栏、绘图工具栏等。

二、QToolBar介绍

1. 简介

QToolBar是Qt框架中的一个控件，用于在工具栏中显示一组操作按钮和其他控件。它提供了一种方便的方式来组织和管理应用程序中的工具和操作。QToolBar可以包含各种类型的控件，如按钮、下拉菜单、文本框等。可以通过添加和删除控件来自定义工具栏的内容。QToolBar还提供了许多内置的功能，如可拖动的工具栏、可停靠的工具栏，以及工具栏按钮的自定义样式等。使用QToolBar，开发人员可以轻松地创建一个功能丰富且易于使用的工具栏，以增强应用程序的用户体验和功能性。

2. 常用属性

3. 常用方法

三、代码创建工具栏

1. 创建工具栏

创建工具栏，并使用addToolBar() 函数添加到窗口中

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

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include<QToolBar>
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    QToolBar * toolbar = new QToolBar();
    this->addToolBar(toolbar);
}
MainWindow::~MainWindow()
{
    delete ui;
}

此时运行结果

2. 添加快捷项

在工具栏中添加快捷项等同于菜单项

QAction()

，并使用addAction()函数添加到工具栏中

//创建快捷项等同于菜单项
QAction * action1 = new QAction("新建");
QAction * action2 = new QAction("保存");
//添加到工具栏中
toolbar->addAction(action1);
toolbar->addAction(action2);

此时运行结果

3. 设置工具栏图标

在阿里巴巴矢量图标库中进行查看合适的图标，如下图

将图片加入到qrc文件中，详细步骤参考文章：qrc文件机制

将图片添加到快捷项中

//创建快捷项等同于菜单项
QAction * action1 = new QAction("新建");
//使用setIcon添加图标
action1->setIcon(QIcon(":/new.png"));
QAction * action2 = new QAction("保存");
action2->setIcon(QIcon(":/save.png"));

此时运行结果

4. 设置提示信息（toolTip）

在上述操作中，将快捷项设置图标后，本来的文字没有消失，默认变成toolTip的形式存在

也可以通过setToolTip的方法改变提示信息

QAction * action2 = new QAction("保存");
action2->setIcon(QIcon(":/save.png"));
action2->setToolTip("这是保存按钮");

运行结果

5. 设置工具栏初始位置

在MainWindow 提供的addToolBar()中设置工具栏的默认停靠位置

在创建⼯具栏的同时，也可以设置⼯具栏的位置，其默认位置是在窗⼝的最上⾯，其中可以设置的位置包括：

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

//添加工具栏
QToolBar * toolbar = new QToolBar();
//创建工具栏的同时，指定工具栏在左侧显示
this->addToolBar(Qt::LeftToolBarArea ,toolbar);

运行结果

6. 设置工具栏停放的边缘

使用 QToolBar类 提供的 setAllowedAreas()函数 设置停靠位置。如下：

其中可以设置的位置包括：

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

#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(toolbar2);
    QAction* action1 = new QAction("文件");
    QAction* action2 = new QAction("构建");
    toolbar1->addAction(action1);
    toolbar2->addAction(action2);
    //只运行左侧停靠
    toolbar1->setAllowedAreas(Qt::LeftToolBarArea);
    //运行在左右停靠
    toolbar2->setAllowedAreas(Qt::LeftToolBarArea | Qt::RightToolBarArea);
}
MainWindow::~MainWindow()
{
    delete ui;
}

运行结果

7. 设置工具栏的浮动

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

参数：

• true：浮动
• false：不浮动

//允许工具栏浮动
toolbar1->setFloatable(true);
//不允许工具栏浮动
toolbar1->setFloatable(false);

8. 设置工具栏的移动

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

参数：

• true：移动
• false：不移动

//允许工具栏移动
toolbar2->setMovable(true);
//不允许工具栏移动
toolbar2->setMovable(false);

9. 文件相关代码查看

相关代码请查看DuckBro的Gitee仓库