сообщение LB_FINDSTRINGEXACT

Статья
05/12/2022
Чтение занимает 2 мин

Находит первую строку списка, которая точно соответствует указанной строке, за исключением того, что поиск не учитывает регистр.

Параметры

wParam

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

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

lParam

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

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

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

Remarks

Эта функция выполняется успешно, только если указанная строка и элемент списка имеют одинаковую длину (за исключением значения NULL в конце указанной строки) и имеют одинаковые символы.

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

Требования

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

См. также

LB_FINDSTRING