LB_SETCURSEL Message

Platforms

Windows 95: Supported.
Windows 98: Supported.
Windows NT: Requires Windows NT 3.1 or later.
Windows 2000: Supported.
Windows CE: Requires Windows CE 1.0 or later.

Description & Usage

Sending the LB_SETCURSEL message to a single-selection list box sets the item that is currently selected, or clears the selection entirely. For multiple-selection list boxes, send the LB_SETSEL message instead.

Return Value

If successful, the message returns 1. If an error occured, or if the selection was cleared, the message returns LB_ERR.

Visual Basic-Specific Issues

None.

Parameters

wParam: The zero-based index of the item to select. To clear the selection, set this to -1.
lParam: Not used -- set to zero.

Constant Definitions

Const LB_SETCURSEL = &H186
Const LB_ERR = -1

Example

Select the second item in list box List1. To use this example, place a single-selection list box named List1 and a command button named Command1 on a form window.

' This code is licensed according to the terms and conditions listed here.

' Declarations and such needed for the example:
' (Copy them to the (declarations) section of a module.)
Public Declare Function SendMessage Lib "user32.dll" Alias "SendMessageA" (ByVal hWnd As Long, _
	ByVal Msg As Long, wParam As Any, lParam As Any) As Long
Public Const LB_SETCURSEL = &H186

' *** Place the following code inside the form window. ***

Private Sub Command1_Click()
	Dim retval As Long  ' return value
	
	' Change the selection in list box List1 to the second item.
	retval = SendMessage(List1.hWnd, LB_SETCURSEL, ByVal CLng(1), ByVal CLng(0))
End Sub