SetWindowSubclass 函式 (commctrl.h)

安裝或更新視窗子類別回呼。

語法

BOOL SetWindowSubclass(
  [in] HWND         hWnd,
  [in] SUBCLASSPROC pfnSubclass,
  [in] UINT_PTR     uIdSubclass,
  [in] DWORD_PTR    dwRefData
);

[in] hWnd

類型： HWND

正在子類別化之視窗的句柄。

[in] pfnSubclass

類型： SUBCLASSPROC

視窗程式的指標。此指標和子類別標識碼可唯一識別這個子類別回呼。如需回呼函式原型，請參閱 SUBCLASSPROC。

[in] uIdSubclass

類型： UINT_PTR

子類別標識碼。此標識碼與子類別程式可唯一識別子類別。若要移除子類別，請將子類別程式和此值傳遞至 RemoveWindowSubclass 函式。這個值會傳遞至 uIdSubclass 參數中的子類別程式。

[in] dwRefData

類型： DWORD_PTR

參考數據的DWORD_PTR 。此值的意義是由呼叫的應用程式所決定。這個值會傳遞至 dwRefData 參數中的子類別程式。不同的 dwRefData 會與視窗句柄、子類別程式和 uIdSubclass 的每個組合相關聯。

類型： BOOL

如果已成功安裝子類別回呼，則為TRUE;否則為 FALSE。

子類別回呼是由回呼位址和呼叫端定義子類別標識碼的組合來識別。如果尚未安裝回呼位址和標識符組，則此函式會安裝子類別。如果已安裝配對，則此函式只會更新參考數據。

每個回呼都可以儲存參考數據的單一 DWORD_PTR ，當呼叫回呼函式來篩選訊息時，會傳遞至回呼函式。不會對回呼執行參考計數;它可能會重複呼叫 SetWindowSubclass 來改變其參考資料元素的值。

警告您無法使用子類別化協助程式函式，跨線程將視窗子類別化。

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	commctrl.h
程式庫	Comctl32.lib
Dll	Comctl32.dll (5.8 版或更新版本)
API 集合	ext-ms-win-shell-comctl32-window-l1-1-0 (於 Windows 10 10.0.14393 版)