ListBox_SetCurSel macro (windowsx.h)

Sets the currently selected item in a single-selection list box. You can use this macro or send the LB_SETCURSEL message explicitly.

Syntax

int ListBox_SetCurSel(
   HWND hwndCtl,
   int  index
);

Parameters

hwndCtl

Type: HWND

A handle to the control.

index

Type: int

The zero-based index of the item to select, or –1 to clear the selection.

Return value

Type: int

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

Remarks

For more information, see LB_SETCURSEL.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header windowsx.h