LVN_INCREMENTALSEARCH notification code

Notifies a list-view control's parent window that an incremental search has started. This notification code is sent in the form of a WM_NOTIFY message.

LVN_INCREMENTALSEARCH
          
    pnmv = (LPNMLVFINDITEM) lParam;

Parameters

lParam [in]

Pointer to a NMLVFINDITEM structure that describes the notification code. The caller is responsible for allocating this structure, including the contained NMHDR and LVFINDINFO structures. Set the members of the NMHDR structure. The code member must be set to LVN_INCREMENTALSEARCH.

Return value

No return value.

Remarks

The notification receiver casts lParam to retrieve the NMLVFINDITEM structure. The wParam parameter contains the ID of the control that sends this notification code.

This notification code gives an application (or the notification receiver) the opportunity to customize an incremental search. For example, if the search items are numeric, the application can perform a numerical search instead of a string search.

The application sets the lParam member of the LVFINDINFO structure contained in NMLVFINDITEM structure to the result of the search, or to another application defined value to fail the search and indicate to the control how to proceed.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
Commctrl.h
Unicode and ANSI names
LVN_INCREMENTALSEARCHW (Unicode) and LVN_INCREMENTALSEARCHA (ANSI)