Поделиться через


TVM_GETISEARCHSTRING сообщение

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

Параметры

wParam

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

lParam

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

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

Возвращает число символов в строке добавочного поиска.

Комментарии

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

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

Требования

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