LB_INSERTSTRING

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 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 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

See Also

Reference

LB_ADDSTRING
LB_GETITEMDATA
LB_SELECTSTRING
LB_SETITEMDATA
List Boxes Messages