【Qt】修改窗口的标题和图标

  以下操作仅对顶层 widget(独⽴窗口),有效。

修改窗口的标题

一.windowTitle属性

1.概念

是一种在用户界面中显示窗口的标题的属性。它可以用来设置窗口的标题栏文本。

2.API

3.代码示例

eg：设置窗⼝标题

widget.cpp代码：

#include "widget.h"
#include "ui_widget.h"

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

     this->setWindowTitle(QStringLiteral("我自定义的标题"));
}

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

运行：

结果：

注：设置标题时使用中文，可能会在运行时出现乱码

可以使用 QStringLiteral 宏创建 QString 类型的字符串.

eg：setWindowTitle（QStringLiteral（“XXXX”））；

修改窗口的图标

二.windowIcon属性

1.概念

是一种在用户界面中显示窗口的图标的属性。它可以用来设置窗口的图标。

2.API

3.代码示例

eg：以绝对路径方式设置窗口图标

（1）先在 D 盘中放⼀个图⽚, 名字为 dog.jpg

（2）修改 widget.cpp,这里使用绝对路径的方式载入图片

（3）运⾏程序, 可以看到窗⼝图标已经成为上述图⽚

同时，程序在任务栏的图标也改变了：

实际开发中，我们一般不会在代码中通过绝对路径的方式引入图片，因为我们不能保证程序发布后，用户电脑上也有相同的路径。

而如果使用相对路径的话，我们需要确保代码中的相对路径与图片实际所在路径相匹配

补充1：

绝对路径:以盘符(windows)或者以 / (Linux) 开头的路径.

 相对路径:以. (表⽰当前路径)或者以.. (表⽰当前路径上级路径)开头的路径.其中. 经常也 会省略.相对路径的前提是需要明确"当前⼯作⽬录".

补充二：

对于Qt程序来说当前⼯作⽬录可能是变化的.⽐如通过 Qt Creator 运⾏的程序,当前⼯作⽬录是项⽬ 的构建⽬录;直接双击 exe 运⾏, ⼯作⽬录则是 exe 所在⽬录.

所谓构建⽬录,是和 Qt 项⽬并列的, 专⻔⽤来放⽣成的临时⽂件和最终 exe 的⽬录.

   为了避免路径对程序寻找图片资源的影响，Qt引入qrc文件

4.qrc文件（重点）

4.1.概念

qrc⽂件是⼀种XML格式的资源配置⽂件,它⽤XML记录硬盘上的⽂件和对应的随意指定的资 源名称.应⽤程序通过资源名称来访问这些资源.

在Qt开发中,可以通过将资源⽂件添加到项⽬中来⽅便地访问和管理这些资源.这些资源⽂件 可以位于qrc⽂件所在⽬录的同级或其⼦⽬录下.

在构建程序的过程中,Qt 会把资源⽂件的⼆进制数据转成 cpp 代码,编译到 exe中.从⽽使依 赖的资源变得"路径⽆关".

4.2.代码示例

通过 qrc 管理图⽚作为图标

 1)右键项⽬,创建⼀个 Qt Resource File (qrc ⽂件),⽂件名随意起(不要带中⽂),此处叫做resource.qrc

2)在 qrc 编辑器中,添加前缀.

此处我们前缀设置成 / 即可.

 所谓的前缀,可以理解成 "⽬录" .这个前缀决定了后续我们如何在代码中访问资源.

3)在 资源编辑器 中,点击 add Files 添加资源⽂件.此处我们需要添加的是dog.jpg

注意:添加的⽂件必须是在 qrc ⽂件的同级⽬录,或者同级⽬录的⼦⽬录中.因此我们需要把之前 D盘 中的dog.jpg复制到上述⽬录中

添加完毕后,可以在 资源编辑器 中看到添加好的⽂件

4)在代码中使⽤dog.jpg

#include "widget.h"
#include "ui_widget.h"
#include <QIcon>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);
    // 访问到 dog.jpg 资源
     QIcon icon(":/dog.jpg");
     // 设置图标
     this->setWindowIcon(icon);
}

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

注意上述路径的访问规则：

 • 使⽤: 作为开头, 表⽰从 qrc 中读取资源.

 • / 是上⾯配置的前缀

 • dog.jpg 是资源的名称， 需要确保代码中编写的路径和添加到 qrc 中资源的路径匹配.否则资源⽆法被访问(同时也不会有报错 提⽰).

5）运行程序，可以看到图标已经被修改

注：

上述代码其实就是通过 unsigned char数组,把dog.jpg中的每个字节都记录下来.这些代码会被编译 到exe中.后续⽆论exe被复制到哪个⽬录下,都确保能够访问到该图⽚资源.

4.3.qrc机制的优缺点

上述qrc这⼀套资源管理⽅案,优点和缺点都很明显.

优点:确保了图⽚,字体,声⾳等资源能够真正做到"⽬录⽆关",⽆论如何都不会出现资源丢失 的情况.

 缺点:不适合管理体积⼤的资源.如果资源⽐较⼤，⽣成的最终的exe体积就会⽐较⼤,程序运⾏消耗的内存也会增⼤,程序编译的时间也会显著 增加.