LB_INSERTSTRING

This message is sent by an application to insert a string into a list box. Unlike the LB_ADDSTRING message, the LB_INSERTSTRING message does not cause a list with the LBS_SORT style to be sorted.

At a Glance

Header file: Winuser.h
Windows CE versions: 1.0 and later

Syntax

LB_INSERTSTRING wParam = (WPARAM) index;
lParam = (LPARAM)(LPCTSTR) lpsz;

Parameters

index

Zero-based index of the position at which to insert the string. If this parameter is –1, the string is added to the end of the list.

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.

lpsz

Long pointer to the null-terminated string to be inserted.

If you create the list box with an owner-drawn style but without the LBS_HASSTRINGS style, the value of the lpsz parameter is stored as item data instead of the string it would otherwise point to. You can send the LB_GETITEMDATA and LB_SETITEMDATA messages to retrieve or modify the item data.

Return Values

The index of the position at which the string was inserted indicates success. LB_ERR indicates that an error has occurred. LB_ERRSPACE indicates that there is insufficient space to store the new string.

See Also

LB_ADDSTRING, LB_SELECTSTRING