LVM_INSERTMARKHITTEST Message


This is preliminary documentation and is subject to change.

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

Headercommctrl.h
Minimum operating systems Windows NT Whistler


© 2000 Microsoft Corporation. All rights reserved. Terms of use.