CListBox::SelectString

Выполняет поиск элемента списка, соответствующий заданной строке, и если соответствующий элемент найден, то он выбирает элемент.

int SelectString(
   int nStartAfter,
   LPCTSTR lpszItem 
);

Параметры

  • nStartAfter
    Содержит нулевой- основан индекс элемента перед первым элементом, который требуется найти.Когда поиск достигает низ списка, он продолжает из вершины списка обратно к элементу указанному nStartAfter.Если nStartAfter 1, то весь список поискано с самого начала.

  • lpszItem
    Указывает на null- завершенной строке, содержащая префикс пространства имен для поиска.Поиск не зависит от регистра, поэтому эта строка может содержать любые прописными буквами и прописных букв.

Возвращаемое значение

Индекс выбранного элемента, если поиск выполнен успешно.Если поиск был неудачн, то возвращаемое значение LB_ERR и текущее выделение не изменен.

Заметки

Список прокрутке, если необходимый, чтобы отобразить элемент, выбранный в представлении.

Этот функции-члена не может использоваться со списком, который содержит стиль LBS_MULTIPLESEL.

Элемент выбирать только если его начальные символы (с начальной точки) соответствующие символы в строке, определенной lpszItem.

Использование функции-члена FindString чтобы найти строку без выбора элемента.

Пример

// The string to match.
LPCTSTR lpszmyString = _T("item 5");

// Select the item that begins with the specified string.
int nIndex = m_myListBox.SelectString(0, lpszmyString);
ASSERT(nIndex != LB_ERR);

Требования

Header: afxwin.h

См. также

Ссылки

CListBox - класс

Диаграмма иерархии

CListBox::FindString

LB_SELECTSTRING