CListBox::SetCurSel

Selects a string and scrolls it into view, if necessary.

int SetCurSel( 
   int nSelect  
);

Parameters

  • nSelect
    Specifies the zero-based index of the string to be selected. If nSelect is –1, the list box is set to have no selection.

Return Value

LB_ERR if an error occurs.

Remarks

When the new string is selected, the list box removes the highlight from the previously selected string.

Use this member function only with single-selection list boxes.

To set or remove a selection in a multiple-selection list box, use CListBox::SetSel.

Example

// Select the last item in the list box. 
int nCount = m_myListBox.GetCount();
if (nCount > 0)
   m_myListBox.SetCurSel(nCount - 1);

Requirements

Header: afxwin.h

See Also

Reference

CListBox Class

Hierarchy Chart

LB_SETCURSEL

CListBox::GetCurSel

CListBox::SetSel

Other Resources

CListBox Members

Change History

Date

History

Reason

May 2009

Added links to CListBox::SetSel.

Information enhancement.