ListView_MapIndexToID 宏 (commctrl.h)

将项的索引映射到唯一 ID。 可以使用此宏或显式发送 LVM_MAPINDEXTOID 消息。

语法

UINT ListView_MapIndexToID(
   HWND hwnd,
   UINT index
);

参数

hwnd

类型:HWND

列表视图控件的句柄。

index

类型:UINT

包含项索引的 UINT

返回值

类型:UINT

返回唯一 ID。

言论

列表视图控件在内部按索引跟踪项。 这可能导致问题,因为索引在控件存在期间可能会更改。

创建项时,可以使用此宏标记 ID 的项目。 使用此 ID 保证列表视图控件存在期间的唯一性。

若要唯一标识项,请获取从调用返回的索引,例如 IComponent::GetDisplayInfo 并调用 LVM_MAPINDEXTOID。 返回值为唯一 ID。

注意 在多线程环境中,只能确保在承载列表视图控件的线程上返回正确的索引,而不是在后台线程上返回。
 
若要使用 ListView_MapIndexToID,请在清单中指定 Comctl32.dll 版本 6。 有关清单的详细信息,请参阅 启用视觉样式

要求

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