Share via

LVM_MAPIDTOINDEX (Compact 2013)

  • Article

3/28/2014

This message maps the identifier (ID) of an item to an index.

To send this message, call the SendMessage function.

Syntax

lResult = SendMessage(
   (HWND) hWndControl,
   (UINT) LVM_MAPIDTOINDEX, 
   (WPARAM) wParam,    // = (WPARAM) (UINT) id;
   (LPARAM) lParam     // = 0; not used, must be zero
);

Parameters

  • id
    UINT that contains the unique ID of an item.
  • lParam
    Must be zero.

Return Value

Returns the most current index.

Remarks

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

The list-view control can tag an item with an ID when the item is created. You can use this ID to guarantee uniqueness during the lifetime of the list-view control.

If you need the index of an item after an ID is created you can call LVM_MAPIDTOINDEX with the unique ID and it returns the most current index.

Note

In a multithreaded environment, the index is only guaranteed on the thread that hosts the list-view control, not on background threads.

Requirements

Header

commctrl.h

See Also

Reference

List-View Controls Messages