LVM_MAPIDTOINDEX (Windows CE 5.0)

Send Feedback

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

To send this message, call the SendMessage function.

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

OS Versions: Windows CE 5.0 and later.
Header: Commctrl.h.

See Also

List-View Controls Messages

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.