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

news2025/1/12 20:56:06

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

修改窗口的标题

一.windowTitle属性

1.概念

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

2.API

API	说明
windowTitle()	获取到控件的窗⼝标题.
setWindowTitle(const QString& title)	设置控件的窗⼝标题.

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

API	说明
windowIcon()	获取到控件的窗⼝图标. 返回 QIcon 对象.
setWindowIcon(const QIcon& icon)	设置控件的窗⼝图标.

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;
}

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