VC++ 使用 SkinMagic 庫快速實現換膚功能：資源嵌入、初始化、選單切換完整步驟

SkinMagic 是輕量級 MFC 視覺樣式庫，透過攔截非客戶區繪製 (WM_NCPAINT)、客戶區背景擦除 (WM_ERASEBKGND) 等訊息，套用外部皮膚資源 (位圖/定義檔) 實現全視窗換膚。本文記錄從零整合至 MFC 專案的最小步驟。

整合步驟

1. 專案加入庫檔案

• 複製 SkinMagicLib.h、SkinMagicLib.lib、DETOURS.lib 至專案目錄。
• 專案 → 加入現有項目 → 選取上述三檔。

2. 匯入皮膚資源

• 資源檢視 → 右鍵匯入 → 選取皮膚二進位檔 (如 KROMO.skn, DEVIOR.skn)。
• 資源類型設為自訂 SKINMAGIC，ID 分別命名為 KROMO, DEVIOR 等。

3. 標頭檔引入

// stdafx.h
#include "SkinMagicLib.h"

4. InitInstance 初始化庫並載入預設皮膚

BOOL CMyApp::InitInstance() {
  // ... 標準初始化 ...
  if (!ProcessShellCommand(cmdInfo)) return FALSE;

  // === SkinMagic 初始化區塊 ===
  VERIFY(1 == InitSkinMagicLib(AfxGetInstanceHandle(), _T("Demo"), NULL, NULL));
  VERIFY(1 == LoadSkinFromResource(AfxGetInstanceHandle(), _T("KROMO"), _T("SKINMAGIC")));

  VERIFY(1 == SetWindowSkin(m_pMainWnd->m_hWnd, _T("MainFrame")));
  VERIFY(1 == SetDialogSkin(_T("Dialog")));

  ((CMainFrame*)m_pMainWnd)->m_bSkinned = TRUE;
  ((CMainFrame*)m_pMainWnd)->m_nSkinIndex = 0;
  // ============================

  m_pMainWnd->ShowWindow(SW_SHOW);
  m_pMainWnd->UpdateWindow();
  return TRUE;
}

5. 主框架加入換膚選單與處理

// 資源選單 IDR_SKIN_MENU 新增項目：KROMO, DEVIOR, ...
void CMainFrame::OnSkinKromo() {
  LoadSkinFromResource(AfxGetInstanceHandle(), _T("KROMO"), _T("SKINMAGIC"));
  m_nSkinIndex = 0;
}
void CMainFrame::OnSkinDeviOr() {
  LoadSkinFromResource(AfxGetInstanceHandle(), _T("DEVIOR"), _T("SKINMAGIC"));
  m_nSkinIndex = 1;
}
// 依此類推...

關鍵 API 速查

優缺點與替代方案

• 優點：庫極小 (~200KB)、整合極簡 (5 行程式碼)、支援主流 MFC 控制項、無需修改既有 UI 程式碼。
• 缺點：開發已停止、不支援高 DPI / Windows 10+ 深色模式、複雜自繪控制項可能遺漏。
• 替代：BCGControlBar (功能強大但體積大)、CMFCVisualManager (MFC 內建、Visual Studio 2008+)、SkinSharp (.NET)、Qt Style Sheets (跨平台)。