关于 GETDISPINFO 通知的详细理解

关于 GETDISPINFO 通知的详细理解

作者:BlogUpdater |  时间:2024-01-19 |  浏览:438 |  评论已关闭 条评论

你可能会经常看到这样的通知消息:XXN_GETDISPINFO,是不是有点印象了?

这个消息的使用场景:当控件要求其父窗口生成(标记为延迟呈现的)信息时,将使用这个 XXN_GETDISPINFO 通知,这些信息可以通过 LPSTR_TEXTCALLBACK 等来显式生成,也可以通过作为所有者数据控件隐式生成。是不是有点绕?

事实上,控件实际上只是请求有关条目信息的代码(通过类似 LVM_GETITEM 的消息)和生成该信息的代码(LVN_GETDISPINFO 处理程序)之间的中间人。

换句话说,代码执行流程,如下所述:

首先,一个想从列表视图控件中获取条目信息的人会创建一个 LVITEM 结构,并根据需要根据掩码初始化 LVITEM.mask 和其他字段。
(例如,如果设置了 LVIF_TEXT 标志,则还必须将 LVITEM.pszText 和 LVITEM.cchTextMax 设置为缓冲区及其大小。)

然后,它向列表视图控件发送一条LVM_GETITEM消息。列表视图控件查看 LVITEM.mask 以查看需要填写的信息。列表视图可以自行提供的一些信息。信息的其他部分需要列表视图控件的父窗口的帮助。

例如,如果 LVITEM.mask 设置了 LVIF_TEXT 标志,并且项的文本设置为 LPSTR_TEXTCALLBACK,则列表视图需要查阅其父窗口以获取文本。

列表视图控件将 LVN_GETDISPINFO 消息发送给其父窗口,说:“嘿,有人在找信息,请提供 LVITEM.mask 成员中要求的信息。” 父窗口处理消息后,结果将返回给原始调用方。

下面是在返回结果之前发生的一个小奖励步骤: 如果父窗口在 LVITEM.mask 中设置了 LVIF_DI_SETITEM 标志,则返回的值也会保存到列表视图控件中,就像您发送了LVM_SETITEM消息一样。例如,如果设置 LVIF_DI_SETITEM 标志以响应LVIF_TEXT 请求,则返回的文本将保存到列表视图项中,覆盖以前的值 LPSTR_TEXTCALLBACK。如果您只想计算一次结果并让列表视图从一开始就缓存结果,这将非常方便。

请注意,在整个过程中,LVITEM.mask 控制列表视图的原始调用方请求的信息,以及其父视图的列表视图请求的信息。
如果您错误地更改了 LVITEM.mask 的值(除了设置 LVIF_DI_SETITEM 标志,如“奖励步骤”中所述),那么您就干扰了这个 “推卸责任” 的游戏。父窗口处理消息后,结果将返回给原始调用方。但是,如果您修改了 LVITEM.mask,则返回给调用方的结果与调用方请求的结果不同!

例如,如果列表视图看到设置了 LVIF_TEXT 标志,则会将父窗口提供的字符串复制回调用方的缓冲区。但是等一下,如果父窗口是设置 LVIF_TEXT 标志的人,这意味着原始呼叫者没有要求文本。没有缓冲区可以将结果复制回其中。列表视图将字符串复制到未初始化的指针,并因此发生各种内存损坏。

总结

在处理 XXN_GETDISPINFO 通知时,请遵守惯例。掩码指定了要求您提供哪些信息(因此哪些信息将被复制回原始呼叫者)。如果您更改此掩码,原始呼叫者将大吃一惊。

这就像在餐厅里当厨师修改顾客的订单一样。
“哦,这位顾客不想要香菜,那我给他加点葱花作为替代吧。”

最后

Raymond Chen的《The Old New Thing》是我非常喜欢的博客之一,里面有很多关于Windows的小知识,对于广大Windows平台开发者来说,确实十分有帮助。
本文来自:《The GETDISPINFO notifications tell you what information they want》

最近我写了个东西

正如你们所知道的,拓扑梅尔智慧办公平台(Topomel Box)是一款绿色软件,主要面向经常使用电脑的朋友。它提供了各种提升办公效率的小功能,同时操作上尽可能地简单方便。
我想:你值得拥有。

标签:

评论已关闭。