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

Статья
10/24/2024

Возвращает добавочную строку поиска элемента управления "Представление списка". Этот макрос можно использовать или явно отправить сообщение LVM_GETISEARCHSTRING.

Синтаксис

BOOL ListView_GetISearchString(
   HWND  hwndLV,
   LPSTR lpsz
);

Параметры

hwndLV

Тип: HWND

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

lpsz

Тип: LPSTR

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

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

Тип: BOOL

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

Замечания

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

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h

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