CComboBox::SetCurSel

Selects a string in the list box of a combo box.

int SetCurSel(
   int nSelect 
);

Parameters

  • nSelect
    Specifies the zero-based index of the string to select. If –1, any current selection in the list box is removed and the edit control is cleared.

Return Value

The zero-based index of the item selected if the message is successful. The return value is CB_ERR if nSelect is greater than the number of items in the list or if nSelect is set to –1, which clears the selection.

Remarks

If necessary, the list box scrolls the string into view (if the list box is visible). The text in the edit control of the combo box is changed to reflect the new selection. Any previous selection in the list box is removed.

Example

// Select the last item in the combo box.
int nLast = pmyComboBox->GetCount() - 1;
if (nLast >= 0)
   m_pComboBox->SetCurSel(nLast);

Requirements

Header: afxwin.h

See Also

Concepts

CComboBox Class

CComboBox Members

Hierarchy Chart

CComboBox::GetCurSel

CB_SETCURSEL