LVM_INSERTMARKHITTEST message

  • Article

Retrieves the insertion point closest to a specified point.

Parameters

wParam

Pointer to a **POINT** structure that contains the hit test coordinates.

lParam

Pointer to an LVINSERTMARK structure that specifies the insertion point closest to the coordinates defined by the *wParam* 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 contains a -1 in the iItem member.

Note

To use this message, you must provide a manifest specifying Comclt32.dll version 6.0. For more information on manifests, see Enabling Visual Styles.

Requirements

Requirement Value
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]
Header
Commctrl.h