CB_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

The CB_SETCURSEL message chooses which item in the list box portion of a combo box control is selected. Doing so erases the user's previous selection, as well as any other text he may have entered in the text box portion of the control.

Return Value

The message returns the zero-based index of the item that is now selected (the first item has an index of 0, etc.). If an error occured, or if the message specified a list box item that does not exist, the message returns -1.

Visual Basic-Specific Issues

None.

Parameters

wParam: The zero-based index of the list box item to select.
lParam: Not used -- set to 0.

Constant Definitions

Const CB_SETCURSEL = &H14E

Example

' 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 CB_SETCURSEL = &H14E

' Select the second item (index 1) available in the list box portion of the combo
' box control Combo1.
Dim retval As Long  ' return value of message

' Change the current selection of Combo1.
retval = SendMessage(Combo1.hWnd, CB_SETCURSEL, ByVal CLng(1), ByVal CLng(0))