LB_SETCURSEL

  • Article

This message is sent by an application to select a string and scroll it into view, if necessary. When the new string is selected, the list box removes the highlight from the previously selected string.

LB_SETCURSEL wParam = (WPARAM) index; 
  lParam = 0;

Parameters

  • index
    Zero-based index of the string that is selected. If the index parameter is –1, the list box is set to have no selection.
  • lParam
    Not used.

Return Values

LB_ERR indicates that an error has occurred. If the index parameter is –1, the return value is LB_ERR, even though no error occurred.

Remarks

Use this message only with single-selection list boxes. You cannot use it to set or remove a selection in a multiple-selection list box.

Requirements

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

See Also

LB_GETCURSEL | List Box Messages

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.