共用方式為


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 錯誤碼。

言論

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

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

例子

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

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

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 uxtheme.h
連結庫 UxTheme.lib
DLL UxTheme.dll