макрос TreeView_GetISearchString (commctrl.h)

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

Синтаксис

BOOL TreeView_GetISearchString(
   HWND   hwndTV,
   LPTSTR lpsz
);

Параметры

hwndTV

Тип: HWND

Обработка элемента управления "Дерево- представление".

lpsz

Тип: LPTSTR

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

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

Тип: BOOL

Возвращает TRUE, если строка извлекается; FALSE в противном случае.

Замечания

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

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

Требования