活動桌面程式控制全攻略：IActiveDesktop 介面、狀態監聽與實戰範例

問題引入

用戶可透過桌面右鍵 →「活動桌面」→「按 Web 頁查看」啟用/停用活動桌面。如何在程式中：

1. 啟用或停用活動桌面？
2. 檢測當前是否啟用？
3. 監聽用戶手動開關變更？

重要警示：修改用戶桌面設定屬敏感操作，務必經用戶明確同意，以醒目提示確認（如「確定要啟用活動桌面嗎？」），尊重用戶偏好。

核心介面：IActiveDesktop

主要方法：

取得介面指標

IActiveDesktop* pAD;
HRESULT hr = ::CoCreateInstance(
  CLSID_ActiveDesktop,
  NULL,                    // 不支援聚合
  CLSCTX_INPROC_SERVER,
  IID_IActiveDesktop,
  (void**)&pAD
);
// 記得在啟動代碼 (如 InitInstance) 中呼叫 CoInitialize(NULL)

啟用活動桌面

COMPONENTSOPT opt;
opt.dwSize = sizeof(opt);
opt.fActiveDesktop = TRUE;
opt.fEnableComponents = TRUE;
HRESULT hr = pAD->SetDesktopItemOptions(&opt, 0);
// 關鍵：必須套用變更！
pAD->ApplyChanges(AD_APPLY_REFRESH);

文檔未明確說明需呼叫 ApplyChanges，導致設定不生效的常見坑。

檢測活動桌面狀態：兩種方法

方法一：IActiveDesktop::GetDesktopItemOptions

COMPONENTSOPT opt;
opt.dwSize = sizeof(opt);
pAD->GetDesktopItemOptions(&opt);
BOOL bEnabled = opt.fActiveDesktop;

方法二：SHGetSettings (推薦，更可靠)

SHELLFLAGSTATE shfs;
SHGetSettings(&shfs, SSF_DESKTOPHTML);
BOOL bADEnabled = shfs.fDesktopHTML;

SHGetSettings 無需 COM 初始化，直接讀取 Shell 狀態旗標。對應旗標：

監聽用戶手動開關：WM_SETTINGCHANGE

用戶透過桌面選單或屬性對話框切換活動桌面時，Windows 廣播 WM_SETTINGCHANGE：

wParam = 0
lParam = "ShellState" (字串指標)

視窗程序處理：

void CMainFrame::OnSettingChange(UINT uFlags, LPCTSTR pszSection) {
  if (pszSection && _tcscmp(pszSection, _T("ShellState")) == 0) {
    // 活動桌面狀態已變更，執行回應邏輯
  }
  CFrameWnd::OnSettingChange(uFlags, pszSection);
}

註冊表鍵：HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\ShellState。廣播機制同 WM_WININICHANGE (兩者 #define 值相同)。

實戰封裝類：CActiveDesktop

隱藏 COM 細節，使用 CComQIPtr 智慧指標確保正確性：

CActiveDesktop ad;
if (!ad.IsEnabled())
  ad.Enable(TRUE); // 啟用

原始碼簡潔，未封裝所有 IActiveDesktop 功能，可自行擴展。

踩坑記：IActiveDesktop 同步 Bug

現象：呼叫 SetDesktopItemOptions + ApplyChanges 後，立即用 GetDesktopItemOptions 讀取，回傳舊狀態 (開讀關、關讀開)。

原因分析：ApplyChanges 更新註冊表 → 廣播 WM_SETTINGCHANGE → 之後 才更新內部狀態。訊息處理時讀取仍為舊值。

解決方案：改用 SHGetSettings，實測其回傳狀態即時正確，不受此 Bug 影響。

測試程式：TestAD

功能：接收 WM_SETTINGCHANGE 顯示提示、透過 CActiveDesktop 切換狀態、即時顯示當前狀態 (採 SHGetSettings)。

總結

• 啟用/停用：IActiveDesktop::SetDesktopItemOptions + ApplyChanges(AD_APPLY_REFRESH)。
• 狀態檢測：首選 SHGetSettings(&shfs, SSF_DESKTOPHTML)，避開 IActiveDesktop 同步 Bug。
• 變更監聽：處理 WM_SETTINGCHANGE，檢查 lParam == "ShellState"。
• 用戶體驗：修改前務必確認，提供還原選項。