LVN_DELETEALLITEMS notification code

Notifies a list-view control's parent window that all items in the control are about to be deleted. This notification code is sent in the form of a WM_NOTIFY message.

LVN_DELETEALLITEMS

    pnmv = (LPNMLISTVIEW) lParam; 

Parameters

lParam

Pointer to an NMLISTVIEW structure. The iItem member is -1, and the other members are zero.

Return value

To suppress subsequent LVN_DELETEITEM notification codes, return TRUE.

To receive subsequent LVN_DELETEITEM notification codes, return FALSE.

Remarks

A list-view control sends the LVM_DELETEALLITEMS notification code when it is destroyed or when it receives the LVM_DELETEALLITEMS message. If LVM_DELETEALLITEMS does not return TRUE, the control will also send an LVN_DELETEITEM notification code as each item is deleted.

If the LVM_DELETEALLITEMS message handler is in a dialog box procedure, return TRUE from the dialog box procedure, and use the SetWindowLong function with DWL_MSGRESULT to set the message return value.

Requirements

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