ListView_SetCallbackMask宏 (commctrl.h)

更改列表视图控件的回调掩码。 可以使用此宏或显式发送 LVM_SETCALLBACKMASK 消息。

语法

BOOL ListView_SetCallbackMask(
   HWND hwnd,
   UINT mask
);

参数

hwnd

类型:HWND

列表视图控件的句柄。

mask

类型:UINT

回调掩码的值。 掩码的位指示应用程序存储当前状态数据的项状态或图像。 此值可以是以下常量的任何组合:

价值 意义
LVIS_CUT
该项标记为剪切和粘贴操作。
LVIS_DROPHILITED
该项突出显示为拖放目标。
LVIS_FOCUSED
该项具有焦点。
LVIS_SELECTED
已选择该项。
LVIS_OVERLAYMASK
应用程序存储每个项的当前覆盖图像的图像列表索引。
LVIS_STATEIMAGEMASK
应用程序存储每个项的当前状态图像的图像列表索引。

返回值

类型:BOOL

如果成功,则返回 TRUE;否则返回 FALSE

言论

列表视图控件 回调掩码是一组位标志,用于指定应用程序(而不是控件)存储当前数据的项状态。 回调掩码适用于控件的所有项,这与应用于特定项的回调项指定不同。 默认情况下,回调掩码为零,这意味着列表视图控件存储所有项状态信息。 创建列表视图控件并初始化其项后,可以使用 ListView_SetCallbackMask 宏或 LVM_SETCALLBACKMASK 消息更改回调掩码。 若要检索当前回调掩码,请发送 LVM_GETCALLBACKMASK 消息。

有关覆盖图像和状态图像的详细信息,请参阅 List-View 图像列表

有关列表视图回调的详细信息,请参阅 回调项和回调掩码

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 commctrl.h

另请参阅

LVN_GETDISPINFO