SetWindowTheme 函式（uxtheme.h）

讓視窗使用與一般類別不同的一組視覺樣式資訊。

語法

HRESULT SetWindowTheme(
  [in] HWND    hwnd,
  [in] LPCWSTR pszSubAppName,
  [in] LPCWSTR pszSubIdList
);

[in] hwnd

類型：HWND

要變更其可視化樣式信息的視窗句柄。

[in] pszSubAppName

類型：LPCWSTR

字串的指標，其中包含要用來取代呼叫應用程式名稱的應用程式名稱。如果此參數 NULL，則會使用呼叫的應用程式名稱。

[in] pszSubIdList

類型：LPCWSTR

字串的指標，其中包含要用來取代視窗類別所傳遞之實際清單的CLSID名稱分號清單。如果此參數 NULL，則會使用來自呼叫類別的標識符清單。

類型：HRESULT

如果函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

主題管理員會保留 pszSubAppName 和 pszSubIdList 關聯，即使視覺效果樣式後續變更也一樣。視窗會在 SetWindowTheme 呼叫結尾傳送 WM_THEMECHANGED 訊息，以便找到並套用新的視覺樣式。

當 pszSubAppName 和 pszSubIdListNULL時，主題管理員會移除先前套用的關聯。您可以藉由指定空字串（L“”），來防止視覺樣式套用至指定的視窗，這不符合任何區段專案。

下列範例程式代碼會提供清單檢視控制項 Windows 檔案總管清單的外觀：

SetWindowTheme(hwndList, L"Explorer", NULL);