CListCtrl::SetBkImage

CListCtrl::SetBkImage函式用來設定列表視圖控制項的背景圖像。

函式功能

設定列表視圖控制項的背景圖像。

函式原型

BOOL SetBkImage(LVBKIMAGE* plvbkImage );

BOOL SetBkImage(HBITMAP hbm, BOOL fTile = TRUE,int xOffsetPercent = 0,i nt 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操作自動執行。

示例

LVBKIMAGE bki;
// If no background image is set for the list view control use
// the Microsoft homepage image as the background image.

if (m_myListCtrl.GetBkImage(&bki) && (bki.ulFlags == LVBKIF_SOURCE_NONE))
{
m_myListCtrl.SetBkImage(_T("1.gif"),TRUE);
}