CListCtrl::SetBkImage

Статья
06/10/2015

Устанавливает образом фоновое изображение элемента управления "список".

BOOL SetBkImage( 
   LVBKIMAGE* plvbkImage  
); 
BOOL SetBkImage( 
   HBITMAP hbm, 
   BOOL fTile = TRUE, 
   int xOffsetPercent = 0, 
   int yOffsetPercent = 0 
); 
BOOL SetBkImage( 
   LPTSTR pszUrl, 
   BOOL fTile = TRUE, 
   int xOffsetPercent = 0, 
   int yOffsetPercent = 0  
);

Параметры

plvbkImage
Адрес структуры LVBKIMAGE, содержащий новые данные фонового изображения.
hbm
Дескриптор растровое изображение.
pszUrl
NULL- Готовая строка, содержащая URL-адрес фонового изображения.
fTile
Ненулевой, если образ быть замосщенным в фоновом режиме управления "список"; в противном случае – значение 0.
xOffsetPercent
Смещение (в точках) левого края образа из начала координат управления "список".
yOffsetPercent
Смещение (в точках) верхнего края образа, из начала координат управления "список".

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

Возвращает ненулевое значение, если успешно или нуль в противном случае.

Заметки

Примечание

Поскольку CListCtrl::SetBkImage использует функциональность OLE модели COM OLE библиотеки необходимо инициализировать перед использованием SetBkImage.Наилучший инициализации библиотеки COM, когда инициализируется приложение и uninitialize библиотеки, когда приложение завершает.Это можно сделать автоматически в приложениях MFC, использующих технологию ActiveX, ole-автоматизации, связывание и внедрения OLE или операциях ODBC/DAO.

Пример

См. пример для CListCtrl::GetBkImage.

Требования

Header: afxcmn.h

См. также

Ссылки

Класс CListCtrl

Диаграмма иерархии

CListCtrl::GetBkImage

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