CListCtrl::SetBkImage

發行項
02/28/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 功能，必須在使用前初始化 SetBkImageOLE 程式庫。初始化 COM 程式庫，最好應用程式初始化和呼叫以取消初始化程式庫時，當應用程式結束時。這在使用 ActiveX 技術， OLE Automation， OLE 連結或內嵌的 MFC 應用程式，或是 ODBC/DAO 作業會自動執行。