这个问题在 SO 上有很多重复和几乎重复,但我所看到的几乎没有一个答案探索了他们选择的解决方案的缺陷。
将任意数据指针与窗口关联的方法有多种,有两种不同的情况需要考虑。根据情况,可能性是不同的。
情况 1 是在您创作窗口类时。这意味着您正在实现WNDPROC
,并且您的意图是其他人在他们的应用程序中使用您的窗口类。您通常不知道谁将使用您的窗口类,以及用于什么。
情况 2 是当您使用自己的应用程序中已经存在的窗口类时。通常,您无权访问窗口类源代码,也无法对其进行修改。
我假设问题不是将数据指针放入WNDPROC
最初的位置,而是如何存储它以供后续调用。
方法一:cbWndExtra
当 Windows 创建一个窗口的实例时,它会在内部分配一个WND
结构。这个结构有一定的大小,包含各种与窗口相关的东西,比如它的位置、它的窗口类和它当前的 WNDPROC。在该结构的末尾,Windows 可选择分配一些属于该结构的附加字节。数字在 中指定,在WNDCLASSEX.cbWndExtra
中使用RegisterWindowClassEx
。
这意味着只有当您是注册窗口类的人时才能使用此方法,即您正在编写窗口类。
应用程序不能直接访问该WND
结构。相反,使用GetWindowLong[Ptr]
. 非负索引访问结构末尾额外字节内的内存。“0”将访问第一个额外的字节。
如果您正在创作窗口类,这是一种干净、快速的方法。大多数 Windows 内部控件似乎都使用这种方法。
不幸的是,这种方法在对话(DialogBox
家庭)中表现不佳。除了提供对话框模板之外,您还有一个对话框窗口类,维护起来会变得很麻烦(除非您出于其他原因需要这样做)。如果您确实想将它与对话框一起使用,则必须在对话框模板中指定窗口类名称,确保在显示对话框之前已注册此窗口类,并且您需要为WNDPROC
对话框实现一个(或使用DefDlgProc
)。偏移对额外内存的所有访问DLGWINDOWEXTRA
(包括cbWndExtra
-- 这是因为在内部,对话框已经需要一些额外的内存才能正常运行)。另请参阅下面的对话框独有的额外方法。
方法二:GWLP_USERDATA
上述WND
结构恰好包含一个指针大小的字段,系统不使用该字段。使用GetWindowLongPtr
负索引(即GWLP_USERDATA
)访问它。负索引将访问WND
结构内的字段。请注意,根据this,负索引似乎并不代表内存偏移,而是任意的。
问题GWLP_USERDATA
是不清楚,过去也不清楚这个字段的确切目的是什么,因此这个字段的所有者是谁。另请参阅此问题。普遍的共识是没有共识。这很可能GWLP_USERDATA
是由窗口的用户使用的,而不是窗口类的作者。这意味着在 WNDPROC 内部使用它是完全错误的,因为 WNDPROC 总是由窗口类作者提供。
我知道的所有标准窗口控件(例如BUTTON
,EDIT
等)都遵守这一点并且不在GWLP_USERDATA
内部使用,将其留给使用这些控件的窗口。问题是有太多的例子,包括在 MSDN 和 SO 上,它们打破了这个规则并GWLP_USERDATA
用于窗口类的实现。这有效地消除了控制用户将上下文指针与其关联的最干净和最简单的方法,仅仅是因为太多人在做“错误”。在最坏的情况下,用户代码不知道它GWLP_USERDATA
已被占用,并且可能会覆盖它,这可能会使应用程序崩溃。
由于长期存在关于 所有权的争议GWLP_USERDATA
,使用它通常并不安全。如果您正在创作一个窗口类,那么您可能永远都不应该使用它。如果你正在使用一个窗口,你应该只在你确定它没有被窗口类使用时才这样做。
方法三:SetProp
SetProp
函数族实现对属性表的访问。每个窗口都有自己独立的属性。该表的键是 API 表面级别的字符串,但在内部它实际上是一个 ATOM。
SetProp
可以由窗口类作者和窗口用户使用,它也有问题,但它们与GWLP_USERDATA
. 您必须确保用作属性键的字符串不会发生冲突。winodw 用户可能不一定知道窗口类作者在内部使用的字符串。即使不太可能发生冲突,您也可以通过使用 GUID 作为字符串来完全避免它们,例如。从全局 ATOM 表的内容可以看出,许多程序都以这种方式使用 GUID。
SetProp
必须小心使用。大多数资源都没有解释这个函数的缺陷。在内部,它使用GlobalAddAtom
. 这有几个含义,在使用此功能时需要考虑:
ATOM
您可以使用注册新字符串时获得的 来代替字符串GlobalAddAtom
。ATOM 只是一个整数。这将提高性能;SetProp
内部总是使用ATOM
s 作为属性键,而不是字符串。传递一个ATOM
跳过搜索全局原子表中的字符串。
全局原子表中可能的字符串原子数在系统范围内限制为 16384。使用许多不同的属性名称是一个坏主意,更不用说这些名称是在运行时动态生成的。相反,您可以使用单个属性来存储指向包含您需要的所有数据的结构的指针。
如果您使用的是 GUID,则可以安全地对正在使用的每个窗口使用相同的 GUID,即使跨不同的软件项目也是如此,因为每个窗口都有自己的属性。这样,您的所有软件最多只会用完全局原子表中的两个条目(您最多需要一个 GUID 作为窗口类作者,最多需要一个 GUID 作为窗口类用户)。事实上,定义两个事实上的标准 GUID 可能是有意义的,每个人都可以将其用于他们的上下文指针。
因为属性使用GlobalAddAtom
,所以您必须确保原子未注册。进程存在时全局原子不会被清理,并且会阻塞全局原子表,直到操作系统重新启动。为此,您必须确保RemoveProp
已调用它。这通常是一个好地方WM_NCDESTROY
。
全局原子是引用计数的。这意味着计数器可能会在某些时候溢出。为了防止溢出,一旦原子的引用计数达到 65536,原子将永远留在原子表中,任何数量GlobalDeleteAtom
都无法摆脱它。在这种情况下,必须重新启动操作系统以释放原子表。
如果你想使用 . 避免使用许多不同的原子名称SetProp
。除此之外,SetProp
/GetProp
是一种非常干净和防御性的方法。如果开发人员同意对所有窗口使用相同的 2 个 atom 名称,则可以大大减轻 atom 泄漏的危险,但这不会发生。
方法四:SetWindowSubclass
SetWindowSubclass
旨在允许覆盖WNDPROC
特定窗口的 ,以便您可以在自己的回调中处理一些消息,并将其余消息委托给原始WNDPROC
. 例如,这可用于侦听EDIT
控件中的特定键组合,而将其余消息留给其原始实现。
一个方便的副作用SetWindowSubclass
是新的,替换WNDPROC
实际上不是一个WNDPROC
,而是一个SUBCLASSPROC
。
SUBCLASSPROC
有 2 个附加参数,其中之一是DWORD_PTR dwRefData
. 这是任意指针大小的数据。数据来自您,通过最后一个参数调用SetWindowSubclass
. 然后将数据传递给替换的每次调用SUBCLASSPROC
。如果每个 WNDPROC
人都有这个参数!
此方法仅对窗口类作者有所帮助。(1)在窗口的初始创建期间(例如WM_CREATE
),窗口子类化自身(例如,它可以使用dwRefData
from lParam
,或者如果合适的话,就在那儿分配它)。通常会进入的其余代码WNDPROC
被移到替换处SUBCLASSPROC
。
它甚至可以用在对话框自己的WM_INITDIALOG
消息中。如果对话框显示为DialogParamW
,则最后一个参数可以用作消息dwRefData
中的SetWindowSubclass
调用WM_INITDIALOG
。然后,所有其余的对话逻辑都进入 new SUBCLASSPROC
,它将dwRefData
为每条消息接收这个。请注意,这会稍微改变语义。您现在正在编写对话框的窗口过程级别,而不是对话框过程。
在内部,使用原子名称为SetWindowSubclass
的属性(使用) 。每个实例都使用这个名称,因此它几乎已经在任何系统的全局原子表中。它将窗口的原始文件替换为被调用的. 该函数使用属性中的数据来获取并调用所有已注册的函数。这也意味着您可能不应该将任何东西用作您自己的属性名称。SetProp
UxSubclassInfo
SetWindowSubclass
WNDPROC
WNDPROC
MasterSubclassProc
UxSubclassInfo
dwRefData
SUBCLASSPROC
UxSubclassInfo
方法 5:重击
thunk 是可以执行的动态生成的函数。它的目的是调用另一个函数,但附加的参数似乎不知从何而来。
这将让您定义一个类似于 的函数WNDPROC
,但它有一个附加参数。此参数可以等效于“this”指针。然后,在创建窗口时,您将原始存根替换为WNDPROC
一个 thunk,该 thunk 调用了WNDPROC
带有附加参数的 real, pseudo-。
其工作方式是,当创建 thunk 时,它会在内存中为加载指令生成机器代码,将额外参数的值加载为常量,然后跳转指令到函数的地址,这通常需要附加参数。然后可以调用 thunk 本身,就好像它是常规的一样WNDPROC
。
此方法可供窗口类作者使用,而且速度极快。但是,实施并非易事。AtlThunk
函数族实现了这一点,但有一个怪癖。它不添加额外的参数。相反,它用您的任意数据替换HWND
参数。WNDPROC
但是,这不是一个大问题,因为您的任意数据可能包含HWND
窗口的。
与该方法类似SetWindowSubclass
,您将在窗口创建期间使用任意数据指针创建 thunk。WNDPROC
然后,用thunk替换窗口。所有真正的工作都在新的、伪的WNDPROC
中,这是 thunk 的目标。
Thunks 根本不会弄乱全局原子表,也没有字符串唯一性考虑。但是,就像在堆内存中分配的所有其他内容一样,它们必须被释放,之后可能不再调用 thunk。因为WM_NCDESTROY
是窗口收到的最后一条消息,所以这里就是这样做的地方。否则,您必须确保WNDPROC
在释放 thunk 时重新安装原件。
请注意,这种将“this”指针偷运到回调函数中的方法实际上在许多生态系统中无处不在,包括 C# 与本机 C 函数的互操作。
方法六:全局查找表
无需长篇大论。在您的应用程序中,实现一个全局表,在其中将HWND
s 存储为键,将上下文数据存储为值。你有责任清理桌子,如果需要,让它足够快。
窗口类作者可以使用私有表来实现他们的实现,窗口用户可以使用他们自己的表来存储特定于应用程序的信息。无需担心原子或字符串的唯一性。
底线
如果您是Window 类作者,则这些方法有效:
cbWndExtra, (GWLP_USERDATA), SetProp, SetWindowSubclass, Thunk, 全局查找表。
Window Class Author 表示您正在编写WNDPROC
函数。例如,您可能正在实现一个自定义图片框控件,它允许用户平移和缩放。您可能需要额外的数据来存储平移/缩放数据(例如,作为 2D 转换矩阵),以便您可以WM_PAINT
正确实现代码。
建议:避免使用 GWLP_USERDATA,因为用户代码可能依赖它;如果可能,请使用 cbWndExtra。
如果您是Window User,则这些方法有效:
GWLP_USERDATA,SetProp,全局查找表。
窗口用户意味着您正在创建一个或多个窗口并在您自己的应用程序中使用它们。例如,您可能正在动态创建可变数量的按钮,并且每个按钮都与被单击时相关的不同数据相关联。
建议:如果它是标准的 Windows 控件,则使用 GWLP_USERDATA,或者您确定该控件不会在内部使用它。
使用对话框时额外提及
默认情况下,对话框使用cbWndExtra
设置为DLGWINDOWEXTRA
. 可以为对话框定义自己的窗口类,在其中分配,例如,DLGWINDOWEXTRA + sizeof(void*)
然后访问GetWindowLongPtrW(hDlg, DLGWINDOWEXTRA)
。但在这样做的同时,你会发现自己不得不回答你不喜欢的问题。例如,WNDPROC
您使用哪种(您可以使用DefDlgProc
),或者您使用哪种类样式(默认对话框恰好使用CS_SAVEBITS | CS_DBLCLKS
,但祝您找到权威参考)。
在DLGWINDOEXTRA
字节中,对话框碰巧保留了一个指针大小的字段,可以使用GetWindowLongPtr
index访问DWLP_USER
。这是一种额外的GWLP_USERDATA
,并且在理论上也有同样的问题。在实践中,我只见过 this 在DLGPROC
最终被传递给DialogBox[Param]
. 毕竟窗口用户还是有GWLP_USERDATA
. 因此,几乎在所有情况下都可以安全地使用窗口类实现。