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


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

Задает фоновое изображение в элементе управления "Представление списка". Этот макрос можно использовать или явно отправить сообщение LVM_SETBKIMAGE.

Синтаксис

BOOL ListView_SetBkImage(
   HWND        hwnd,
   LPLVBKIMAGE plvbki
);

Параметры

hwnd

Тип: HWND

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

plvbki

Тип: LPLVBKIMAGE

Указатель на структуру LVBKIMAGE , содержащую новые сведения о фоновом изображении.

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

Тип: BOOL

Возвращает ненулевое значение в случае успешного выполнения или нуля. Возвращает ноль, если элемент ulFlags структуры LVBKIMAGE LVBKIF_SOURCE_NONE.

Замечания

Так как элемент управления представлением списка использует OLE COM для управления фоновыми изображениями, вызывающее приложение должно вызывать CoInitialize или OleInitialize перед использованием этого макроса. При инициализации приложения рекомендуется вызывать одну из этих функций и вызывать CoUninitialize или OleUninitialize при завершении приложения.

Требования

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

См. также

ListView_GetBkImage