Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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.

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.

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 lpszparameter is stored as item data instead of the string it would otherwise point to. You can send the LB_GETITEMDATAand LB_SETITEMDATAmessages to retrieve or modify the item data.

Return Value

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.

Requirements

Header winuser.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also