макрос ListBox_SelectItemData (windowsx.h)

Статья
10/24/2024

Выполняет поиск по списку для элемента с указанными данными элемента. Если найден соответствующий элемент, выбран элемент. Этот макрос можно использовать или явно отправить сообщение LB_SELECTSTRING.

Синтаксис

int ListBox_SelectItemData(
   HWND   hwndCtl,
   int    indexStart,
   LPARAM data
);

Параметры

hwndCtl

Тип: HWND

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

indexStart

Тип: int

Отсчитываемый от нуля индекс элемента перед поиском первого элемента. Когда поиск достигает нижней части поля списка, он продолжает поиск в верхней части поля списка обратно к элементу, указанному параметром indexStart. Если indexStart равно –1, все поле списка выполняется с самого начала.

data

Тип: LPARAM

Данные элемента, которые нужно найти.

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

Тип: int

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

Замечания

Дополнительные сведения см. в LB_SELECTSTRING.

Требования

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

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