C++Builder 資源檔完整使用指南：RC 編譯、連結與運行時載入圖示/游標/聲音/位圖

前言

將圖示、游標、位圖、聲音、自訂資料等資源編譯進執行檔，可實現單一檔案部署、防止資源遺失、提升載入速度。本文詳細說明 C++Builder 中 .rc 資源腳本撰寫、BRCC32 編譯、專案連結、以及運行時載入各類資源的標準 API 用法。

步驟一：撰寫 .rc 資源腳本

建立純文字檔 MyRes.rc，格式：

# 資源名稱/ID    資源類型    檔案路徑
MyAppIcon       ICON        "Res\\App.ico"
CursorZoomIn    CURSOR      "Res\\ZoomIn.cur"
CursorZoomOut   CURSOR      "Res\\ZoomOut.cur"
BmpPrintType    BITMAP      "Res\\PrintType.bmp"
BmpArrowUp      BITMAP      "Res\\ArrowUp.bmp"
BmpArrowDown    BITMAP      "Res\\ArrowDown.bmp"
SndHint         WAVE        "Res\\Hint.wav"
ExeUnzip        RCDATA      "Res\\Unzip.exe"   # 自訂二進位資料用 RCDATA

• 資源名稱：字串 (區分大小寫) 或數值 ID (如 101)
• 資源類型：ICON, CURSOR, BITMAP, WAVE, RCDATA, RT_RCDATA 等
• 路徑：相對專案目錄或絕對路徑，建議用相對路徑

步驟二：編譯 .rc 為 .res

# 命令列
BRCC32 MyRes.rc

# 輸出 MyRes.res
# BRCC32 位於 $(BCB)\Bin\
# 也可在 IDE: Project → Add to Project 直接加入 .rc，IDE 自動調用 BRCC32

步驟三：專案連結資源

方法 A：主專案原始碼中宣告 (推薦)

// 主專案 .cpp (如 Main.cpp)
#include 
#pragma hdrstop
USERES("MyRes.res");  // 連結資源檔
// 或
#pragma resource "MyRes.res"
#pragma package(smart_init)

方法 B：單元中宣告

// Unit1.cpp
#pragma resource "*.dfm"
#pragma resource "MyRes.res"  // 額外連結
// 或
#pragma package(smart_init)

步驟四：運行時載入資源

1. 載入位圖 (BITMAP)

Graphics::TBitmap* bmp = new Graphics::TBitmap();
bmp->LoadFromResourceName((unsigned)HInstance, "BmpPrintType");
// 使用: Canvas->Draw(x, y, bmp); 或 Image1->Picture->Assign(bmp);
delete bmp;

2. 播放聲音 (WAVE)

#include   // 需連結 winmm.lib
#pragma comment(lib, "winmm.lib")

// 同步播放 (阻塞)
PlaySound("SndHint", HInstance, SND_RESOURCE | SND_SYNC);

// 非同步播放 (不阻塞)
PlaySound("SndHint", HInstance, SND_RESOURCE | SND_ASYNC);

// 停止播放
PlaySound(NULL, 0, 0);

3. 載入游標 (CURSOR)

// 定義自訂游標常數 (避開系統負數常數)
const TCursor crZoomIn = 100;
const TCursor crZoomOut = 101;

// 載入並註冊
Screen->Cursors[crZoomIn] = LoadCursor(HInstance, "CursorZoomIn");
Screen->Cursors[crZoomOut] = LoadCursor(HInstance, "CursorZoomOut");

// 套用至控件
PaintBox1->Cursor = crZoomIn;
Application->ProcessMessages(); // 確保立即生效

4. 載入圖示 (ICON)

// 載入圖示控制代碼
HICON hIcon = LoadIcon(HInstance, "MyAppIcon");
// 或指定尺寸
HICON hIconLarge = LoadImage(HInstance, "MyAppIcon", IMAGE_ICON, 32, 32, LR_DEFAULTCOLOR);
HICON hIconSmall = LoadImage(HInstance, "MyAppIcon", IMAGE_ICON, 16, 16, LR_DEFAULTCOLOR);

// 設定表單/應用程式圖示
Form1->Icon->Handle = hIcon;           // 表單標題列
Application->Icon->Handle = hIcon;     // 工作列/切換視窗

5. 載入自訂二進位資料 (RCDATA)

HRSRC hRes = FindResource(HInstance, "ExeUnzip", RT_RCDATA);
if (hRes)
{
    HGLOBAL hGlob = LoadResource(HInstance, hRes);
    DWORD size = SizeofResource(HInstance, hRes);
    LPVOID pData = LockResource(hGlob);

    // 寫入暫存檔執行
    char tempPath[MAX_PATH];
    GetTempPath(MAX_PATH, tempPath);
    strcat(tempPath, "unzip.exe");
    HANDLE hFile = CreateFile(tempPath, GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, 0, NULL);
    DWORD written;
    WriteFile(hFile, pData, size, &written, NULL);
    CloseHandle(hFile);

    // 執行...
    // 結束後刪除
    DeleteFile(tempPath);
}

資源類型對應 API 速查表

重要注意事項

• 資源名稱區分大小寫：LoadFromResourceName、FindResource 皆區分大小寫，.rc 定義與呼叫必須完全一致。
• HInstance 來源：EXE 專案用 HInstance (全域變數)；DLL 專案用 HInstance 或 GetModuleHandle("MyDll.dll")。
• 資源釋放：LoadResource/LockResource 取得的指標不可手動 Free，系統在模組卸載時自動回收。LoadIcon/LoadCursor/LoadBitmap 返回的控制代碼需配對 DestroyIcon/DestroyCursor/DeleteObject (但 VCL 封裝類別會自動管理)。
• 部署優勢：編譯後 .res 內容嵌入 .exe，發布時無需攜帶 .rc/.res/.ico/.bmp/.wav 等外部檔案。
• 大小限制：單一資源建議 < 10MB，超大資源 (如內嵌影片) 建議外部檔案或資料庫。

常見問題排查

善用資源檔機制，讓你的 C++Builder 應用程式擁有專業的視覺/聽覺資產管理，實現真正的單一檔案綠色部署。

1. 上一篇文章： C++Builder 目錄選擇對話框兩種實作：SHBrowseForFolder 與 SelectDirectory
2. 下一篇文章： C++Builder 將 EXE 內嵌 SWF 提取轉換為獨立 SWF 檔案

VC 教學

MFC 視窗類封裝核心：Thunk 技術深度解析與實現

前言：為何要重造輪子？ MFC（Microsoft Foun

Microsoft RTC API 多用戶端通訊實戰 (三)：XML 佈建、好友清單與效能優化

XML 佈建文件產生 RTC 用戶端需 XML 字串描述裝置

Visual Studio 除錯緩慢？關閉「載入符號」加速編譯啟動

現象 啟動偵錯 (F5) 時，輸出視窗大量顯示 載入符號:

VC++ 利用 /GS 編譯器選項防禦緩衝區溢位攻擊

緩衝區溢位威脅概述 緩衝區溢位是最常見的軟體弱點之一。駭客透