LB_INSERTSTRING

  • Article

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.

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

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winuser.h.

See Also

LB_ADDSTRING | LB_GETITEMDATA | LB_SELECTSTRING | LB_SETITEMDATA | List Box Messages

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.