сообщение LVM_GETISEARCHSTRING

Извлекает строку добавочного поиска элемента управления представлением списка. Это сообщение можно отправить явным образом или с помощью макроса ListView_GetISearchString .

Параметры

wParam

Должен равняться нулю.

lParam

Указатель на буфер, который получает строку добавочного поиска. Чтобы просто получить длину строки, присвойте lParam значение NULL.

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

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

Комментарии

Предупреждение системы безопасности: Неправильное использование этого сообщения может поставить под угрозу безопасность программы. Это сообщение не позволяет узнать размер буфера. Если вы используете это сообщение, сначала вызовите сообщение, передавающее значение NULL в lParam. При этом возвращается количество символов, за исключением обязательных значений NULL . Затем вызовите сообщение во второй раз, чтобы получить строку. Прежде чем продолжить, ознакомьтесь с разделом Вопросы безопасности: Элементы управления Microsoft Windows .

Строка добавочного поиска — это последовательность символов, которую пользователь вводит, пока представление списка имеет фокус ввода. Каждый раз, когда пользователь вводит символ, система добавляет его в строку поиска, а затем выполняет поиск соответствующего элемента. Если система находит совпадение, она выбирает элемент и при необходимости прокручивает его в поле зрения.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Commctrl.h
Имя в кодировке Юникод и ANSI	LVM_GETISEARCHSTRINGW (Юникод) и LVM_GETISEARCHSTRINGA (ANSI)