ListView_MapIndexToID macro (commctrl.h)

Maps the index of an item to a unique ID. You can use this macro or send the LVM_MAPINDEXTOID message explicitly.

Syntax

UINT ListView_MapIndexToID(
   HWND hwnd,
   UINT index
);

Parameters

hwnd

Type: HWND

A handle to the list-view control.

index

Type: UINT

A UINT that contains the index of an item.

Return value

Type: UINT

Returns a unique ID.

Remarks

List-view controls internally track items by index. This can present problems because indexes can change during the control's existence.

You can use this macro to tag an item with an ID when you create the item. You use this ID to guarantee uniqueness during the existence of the list-view control.

To uniquely identify an item, take the index that is returned from a call such as IComponent::GetDisplayInfo and call LVM_MAPINDEXTOID. The return value is a unique ID.

Requirements