сообщение LB_SELECTSTRING

  • Статья

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

Параметры

wParam

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

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): параметр wParam ограничен 16-разрядными значениями. Это означает, что списки не могут содержать более 32 767 элементов. Хотя количество элементов ограничено, общий размер элементов в байтах в списке ограничен только доступной памятью.

lParam

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

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

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

Комментарии

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

Не используйте это сообщение со списком со стилями LBS_MULTIPLESEL или LBS_EXTENDEDSEL .

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

Если список имеет стиль, нарисованный владельцем, но не стиль LBS_HASSTRINGS , действие, выполняемое LB_SELECTSTRING , зависит от того, используется ли стиль LBS_SORT . Если используется LBS_SORT , система отправляет WM_COMPAREITEM сообщения владельцу списка, чтобы определить, какой элемент соответствует указанной строке. В противном случае LB_SELECTSTRING пытается найти элемент, имеющий длинное значение (указанное в качестве параметра lParamLB_ADDSTRING или LB_INSERTSTRING сообщения), соответствующее параметру lParam .

Требования

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

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

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

LB_ADDSTRING

LB_FINDSTRING

LB_INSERTSTRING