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

指向窗口过程的指针。此指针和子类 ID 唯一标识此子类回调。有关回调函数原型，请参阅 SUBCLASSPROC。

[in] uIdSubclass

类型： UINT_PTR

子类 ID。此 ID 与子类过程一起唯一标识子类。若要删除子类，请将子类过程和此值传递给 RemoveWindowSubclass 函数。此值传递到 uIdSubclass 参数中的子类过程。

[in] dwRefData

类型： DWORD_PTR

DWORD_PTR 引用数据。此值的含义由调用应用程序确定。此值将传递到 dwRefData 参数中的子类过程。不同的 dwRefData 与窗口句柄、子类过程和 uIdSubclass 的每种组合相关联。

类型： BOOL

如果成功安装子类回调，则为 TRUE;否则为 FALSE。

子类回调由回调地址和调用方定义的子类 ID 的组合标识。如果尚未安装回调地址和 ID 对，则此函数将安装子类。如果已安装对，则此函数仅更新引用数据。

每个回调可以存储引用数据的单个 DWORD_PTR ，当回调函数被调用以筛选消息时，该引用数据将传递给回调函数。不对回调执行引用计数;它可能会重复调用 SetWindowSubclass 来更改其引用数据元素的值。

警告不能使用子类化帮助程序函数跨线程对窗口进行子类化。

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	commctrl.h
Library	Comctl32.lib
DLL	Comctl32.dll (版本 5.8 或更高版本)
API 集	Windows 10版本 10.0.14393 中引入的 ext-ms-win-shell-comctl32-window-l1-1-0 ()