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

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)

 

 

Show: