LB_DELETESTRING

An application sends an LB_DELETESTRING message to delete a string in a list box.

LB_DELETESTRING 
wParam = (WPARAM) index;    // index of string to delete 
lParam = 0;                 // not used; must be zero 
 

Parameters

index

Value of wParam. Specifies the zero-based index of the string to be deleted.

Windows 95 and Windows 98: The wParam parameter is limited to 16-bit values. This means list boxes cannot contain more than 32,767 items. Although the number of items is restricted, the total size in bytes of the items in a list box is limited only by available memory.

Return Values

The return value is a count of the strings remaining in the list. The return value is LB_ERR if the index parameter specifies an index greater than the number of items in the list.

Remarks

If an application creates the list box with an owner-drawn style but without the LBS_HASSTRINGS style, the system sends a WM_DELETEITEM message to the owner of the list box so the application can free any additional data associated with the item.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 1.0 or later.
  Header: Declared in winuser.h.

See Also

List Boxes Overview, List Box Messages, LB_ADDSTRING, LB_INSERTSTRING, WM_DELETEITEM