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