通过

ListView_MapIDToIndex 宏 (commctrl.h)

  • 项目

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

语法

void ListView_MapIDToIndex(
   hwnd,
   id
);

参数

hwnd

类型： HWND

列表视图控件的句柄。

id

类型： UINT

包含项的唯一 ID 的 UINT 。

返回值

无

备注

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

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

若要唯一标识项，请获取从调用（如 IComponent：：GetDisplayInfo）返回的索引，然后调用 LVM_MAPINDEXTOID。 返回值为唯一 ID。

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

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

要求

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