сообщение CB_SELECTSTRING

  • Статья

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

Параметры

wParam

Отсчитываемый от нуля индекс элемента, предшествующего первому элементу для поиска. Когда поиск достигает нижней части списка, он продолжается от верхней части списка обратно к элементу, указанному параметром wParam . Если wParam имеет значение -1, поиск по всему списку выполняется с самого начала.

lParam

Указатель на строку, завершающуюся значением NULL, содержащую символы, для которых выполняется поиск. При поиске регистр не учитывается, поэтому эта строка может содержать любое сочетание прописных и строчных букв.

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

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

Комментарии

Строка выбирается, только если символы из начальной точки совпадают с символами в строке префикса.

Если вы создаете поле со списком со стилем, нарисованным владельцем, но без стиля CBS_HASSTRINGS , CB_SELECTSTRING сообщение зависит от того, используется ли стиль CBS_SORT . Если используется стиль CBS_SORT , система отправляет WM_COMPAREITEM сообщения владельцу поля со списком, чтобы определить, какой элемент соответствует указанной строке. Если стиль CBS_SORT не используется, CB_SELECTSTRING пытается сопоставить значение DWORD со значением параметра lParam .

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Заголовок
Winuser.h (включая Windows.h)

См. также раздел

Справочные материалы

CB_FINDSTRING

CB_FINDSTRINGEXACT

CB_SETCURSEL

WM_COMPAREITEM