CB_INSERTSTRING

  • Article

This message is sent by an application to insert a string into the list box of a combo box. Unlike the CB_ADDSTRING message, the CB_INSERTSTRING message does not cause a list with the CBS_SORT style to be sorted.

CB_INSERTSTRING wParam = (WPARAM) index; 
  lParam = (LPARAM)(LPCSTR) lpsz;

Parameters

  • index
    Specifies the 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 combo box with an owner-drawn style but without the CBS_HASSTRINGS style, the value of the lpsz parameter is stored rather than the string it would otherwise point to.

Return Values

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

Requirements

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

See Also

Combo Box Messages | SendMessage | CB_ADDSTRING

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.