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

Статья
10/24/2024

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

Синтаксис

int ListBox_InsertItemData(
   HWND   hwndCtl,
   int    index,
   LPARAM data
);

Параметры

hwndCtl

Тип: HWND

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

index

Тип: int

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

data

Тип: LPARAM

Указатель на данные элемента для вставки.

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

Тип: int

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

Замечания

Используйте этот макрос для поля списка с нарисованным владельцем стилем, но без стиля LBS_HASSTRINGS. Дополнительные сведения см. в LB_INSERTSTRING.

Требования

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

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