Share via

ListView_MapIndexToID (Compact 2013)

  • Article

3/28/2014

This macro maps the index of an item to a unique identifier (ID). You can use this macro or send the LVM_MAPINDEXTOID message explicitly.

Syntax

UINT ListView_MapIndexToID(
   HWND hwnd,
   UINT index
);

Parameters

  • hwnd
    Handle to the list-view control.
  • index
    UINT that contains the index of an item.

Return Value

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.

Note

In a multithreaded environment, you can only be sure the correct index is returned on the thread that hosts the list-view control, not on background threads.

Requirements

Header

commctrl.h

See Also

Reference

List-View Controls Macros