Retrieves the insertion point closest to a specified point.
To send this message, call the SendMessage function as follows.
lResult = SendMessage( // returns BOOL in lResult (HWND) hWndControl, // handle to destination control (UINT) LVM_INSERTMARKHITTEST, // message ID (WPARAM) wParam, // = (WPARAM) (LPPOINT) point (LPARAM) lParam // = (LPARAM) (PLVINSERTMARK) plvim );
Parameters
- point
- [in] Pointer to a POINT structure that contains the hit test coordinates.
- plvim
- [in] Pointer to an LVINSERTMARK structure that specifies the insertion point closest to the coordinates defined by the point parameter.
Return Value
Returns TRUE if successful, or FALSE otherwise. FALSE is returned if the size in the cbSize member of the LVINSERTMARK structure does not equal the actual size of the structure, or when an insertion point does not apply in the current view.
Remarks
An insertion point can only appear if the list view control is in icon view, small icon view, or tile view and is not in group view mode.
If insertion points do not apply for the view, the LVINSERTMARK structure will contain a -1 in the iItem member.
Message Requirements
Header commctrl.h Minimum operating systems Windows NT Whistler