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 和 pszSubIdList 為 NULL 時，主題管理員會移除先前套用的關聯。您可以藉由指定空字串， (L“ ”) ，而不符合任何區段專案，以防止可視化樣式套用至指定的視窗。

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

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