ListView_MapIDToIndex 宏 (commctrl.h)

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

语法

UINT ListView_MapIDToIndex(
   HWND hwnd,
   UINT id
);

参数

hwnd

类型:HWND

列表视图控件的句柄。

id

类型:UINT

包含项的唯一 ID 的 UINT

返回值

类型:UINT

返回最新的索引。

言论

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

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

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

如果在创建 ID 后需要知道项的索引,请使用唯一 ID 调用 LVM_MAPIDTOINDEX,并返回最新的索引。

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

要求

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