CListCtrl::SetBkImage

项目
03/01/2013

设置列表视图控件的背景图像。

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函数，必须在使用 SetBkImage之前初始化OLE库。初始化COM库，最好在应用程序中初始化和uninitialize库时，应用程序终止时。这在使用ActiveX技术，OLE自动化，OLE链接/嵌入的MFC应用程序，也ODBC/DAO操作自动执行。