1. 程式人生 > >寫一個Qt資原始檔(qrc)

寫一個Qt資原始檔(qrc)

原文地址:http://my.chinaunix.net/space.php?uid=25601623&do=blog&id=335144

一個.qrc 檔案的例子:

<!DOCTYPE RCC><RCC version="1.0">

    <qresource>

        <file>images/copy.png</file>

        <file>images/cut.png</file>

        <file>images/new.png</file>

        <file>images/open.png</file>

        <file>images/paste.png</file>

        <file>images/save.png</file>

    </qresource>

</RCC>

.qrc 檔案中列出的資原始檔是程式的原始碼樹的一部分。指定的路徑是 .qrc 檔案所在目錄的相對路徑。注意,列出的資原始檔必須位於 .qrc 檔案所在目錄或者其子目錄下。

資源資料也能被編譯進二進位制檔案中,因此應用程式程式碼可以立即訪問;也可以建立一個二進位制資源,稍後在程式中登記了資源體系的程式碼中指定。

預設時,程式可以用資源在原始碼樹中的名稱加一個 :/ 字首來訪問它。例如,在程式的原始碼樹中是 images/cut.png 的檔案可以通過 :/images/cut.png 來訪問。但也可以用 file 標籤中的 alias 屬性來指定:

<file alias="cut-img.png">images/cut.png</file>

這時該檔案可以通過 :/cut-img.png 來訪問。也可以在 .qrc 檔案中用 qresource 標籤的 prefix 屬性:它可以為 .qrc 檔案中所有檔案指定一個字首:

<qresource prefix="/myresources">

 <file alias="cut-img.png">images/cut.png</file>

</qresource>

這時該檔案可以用 :/myresources/cut-img.png 訪問。

有些資源,像翻譯檔案和圖示,需要隨著使用者的本地配置而變化。這可以在 qresource 標籤的 lang 屬性中指定一個合適的本地化字串來實現。例如:

<qresource>

<file>cut.jpg</file>

</qresource>

<qresource lang="fr">

<file alias="cut.jpg">cut_fr.jpg</file>

</qresource>

如果使用者的本地化設定是 French (也就是說,QLocale::system().name() returns "fr_FR"),:/cut.jpg 就會引用 cut_fr.jpg 影象。對於其他本地化設定,仍然用 cut.jpg 。

本地化字串的使用格式參見 QLocale 文件。

使用外部二進位制資源

為建立一個外部二進位制資源,需要通過向 rcc 傳遞 -binary 開關來生成資源資料(一般是.rcc副檔名)。然後可以用 QResource API 來註冊資源。例如,一個 .qrc 檔案指定的資源資料集可以用下面方法編譯:

rcc -binary myresource.qrc -o myresource.rcc

應用程式中,用下面的程式碼註冊資源: QResource::registerResource("/path/to/myresource.rcc");

Compiled-In Resources

必須在應用程式的 .pro 檔案中指定.qrc 檔案, qmake 才能知道並將資源編譯進二進位制檔案。例如:

RESOURCES  +  = application.qrc

qmake 將產生make規則來生成一個叫做 qrc_application.cpp 的檔案並把它連結到應用程式中。該檔案中,影象和其他資源的所有資料被以壓縮二進位制資料存進靜態C++陣列中。 .qrc 檔案被改變或者它引用的檔案中的某一個被改變時, qrc_application.cpp 自動重新生成。若你沒有使用 .pro 檔案,你也可以手動呼叫 rcc 或者在你的編譯系統中新增建立規則。

通常,Qt直接將資料儲存在可執行檔案中,甚至在Windows和Mac OS X這些提供資源本地支援的作業系統中也是這樣。這可能會在未來的Qt版本中改變。

Using Resources in the Application

應用程式中,絕大多數地方都可以用資源路徑代替原始檔案系統路徑。尤其是在 QIcon, QImage, or QPixmap 構造器中可以傳遞資源路徑來代替檔名稱:

     cutAct = new QAction(QIcon(":/images/cut.png"), tr("Cu&t"), this);

在記憶體中,資源被用資源物件樹來描述。該樹在啟動時自動構建並用QFile來解析資源路徑。可以用":/" 初始化的 QDir 來從資源樹的根部開始瀏覽。

Qt資源支援搜尋路徑列表概念。若用 ":"代替":/"做字首來引用一個資源,資源將被用搜索路徑列表查詢。啟動時搜尋路徑列表是空的,呼叫 QDir::addResourceSearchPath() 可以新增路徑。

If you have resources in a static library,必須用.qrc 檔案的base name作引數呼叫 Q_INIT_RESOURCE() 來強制初始化資源。例如:

     int main(int argc, char *argv[])

     {

         QApplication app(argc, argv);

         Q_INIT_RESOURCE(graphlib);

         ...

         return app.exec();

     }

同樣地,若你需要顯式解除安裝一個資源集(因外掛被解除安裝或資源失效),需要用與前面相同的base name為引數呼叫Q_CLEANUP_RESOURCE() 來強制移除資源。