Qt 中资源文件的添加及使用

---

目录

1. Qt 中资源文件的添加及使用
   • 1.1 创建资源文件
     • 1.1.1 在 Qt Creator 中创建资源文件
     • 1.1.2 编辑资源文件
   • 1.2 起别名
     • 1.2.1 在资源文件中设置别名
     • 1.2.2 使用已经起别名的资源
       • 1.2.2.1 加载图像
       • 1.2.2.2 使用图标
       • 1.2.2.3 播放音频
2. 编译和运行
3. 小提示

---

---

Qt 中资源文件的添加及使用

概述

在 Qt 开发中，资源文件（.qrc 文件）用于将图像、音频等静态文件打包进程序中。这使得您的应用能够更加独立，无需依赖外部文件。本文将详细介绍如何在 Qt 项目中添加和使用资源文件，并讲解如何对资源文件起别名。

1. 创建资源文件

1.1 在 Qt Creator 中创建资源文件

1. 右键点击项目：

   • 在项目面板中右键点击您要添加资源的项目，选择 Add New...。

2. 选择资源文件类型：

   • 在弹出的窗口中选择 Qt -> Qt Resource File，然后点击 Next。

3. 命名资源文件：

   • 给资源文件命名，例如 resources.qrc，然后点击 Finish。

1.2 编辑资源文件

打开 resources.qrc 文件，您将看到一个 XML 格式的内容。在这里，您可以定义要包含的资源及其路径。

<!DOCTYPE RCC><RCC version="1.0">
    <qresource prefix="/">
        <file>images/logo.png</file>
        <file>sounds/alert.mp3</file>
    </qresource>
</RCC>

• 注意：确保资源文件路径正确，并且文件存在于项目中。

2. 起别名

有时，为了避免文件路径较长，或希望更方便地引用文件，可以对资源文件起别名。在资源文件中，可以使用 prefix 属性来指定资源的前缀。

2.1 在资源文件中设置别名

修改 resources.qrc 文件，给资源添加别名，例如：

<!DOCTYPE RCC><RCC version="1.0">
    <qresource prefix="/myApp"> <!-- 这里设置了自定义前缀 -->
        <file>images/logo.png</file>
        <file>sounds/alert.mp3</file>
    </qresource>
</RCC>

在上面的例子中，资源的前缀设置为 /myApp。这意味着我们在代码中引用这些资源时，只需使用 :/myApp/ 前缀。

2.2 使用已经起别名的资源

加载图像

QPixmap logo(":/myApp/images/logo.png"); // 使用自定义前缀
QLabel *label = new QLabel;
label->setPixmap(logo);

使用图标

如果您想设置窗口图标，可以这样做：

QIcon windowIcon(":/myApp/images/logo.png"); // 使用自定义前缀
this->setWindowIcon(windowIcon);

播放音频

播放音频文件也非常简单：

QSound::play(":/myApp/sounds/alert.mp3"); // 使用自定义前缀

3. 编译和运行

编译并运行您的应用，确保能够看到加载的图像和播放的音效。如果有任何错误，请检查资源路径和文件是否存在。

小提示

• 使用 :/ 前缀标识资源，后面跟随您在资源文件中设置的别名和实际路径。
• 在实际使用之前，请在设计阶段验证所有文件路径是否正确。
• 通过 Qt 的图形界面管理器添加资源文件时，Qt 会自动为您管理路径，减少出错的机会。

---