CListCtrl::SetBkImage

Článek
06/10/2015

Nastaví obrázek pozadí ovládacího prvku seznamu zobrazení.

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  
);

Parametry

plvbkImage
Adresa LVBKIMAGE struktura obsahující informace obrazu.
hbm
Popisovač rastrového obrázku.
pszUrl
A NULL-ukončeno řetězec obsahující adresu URL obrázku pozadí.
fTile
Nenulová hodnota, pokud je obraz se vedle sebe na pozadí ovládacího prvku zobrazení seznamu; jinak 0.
xOffsetPercent
Posun v pixelech levý okraj obrazu původu ovládací prvek seznamu zobrazení.
yOffsetPercent
Posun v pixelech horní okraj obrazu původu ovládací prvek seznamu zobrazení.

Vrácená hodnota

Vrátí nenulová hodnota, pokud je úspěšná nebo jinak nula.

Poznámky

[!POZNÁMKA]

Protože CListCtrl::SetBkImage využívá funkce OLE COM, knihovny OLE musí být inicializováno před použitím SetBkImage .Je nejvhodnější k inicializaci knihovny COM při inicializaci aplikace a její zrušení knihoven při ukončení aplikace.To se provádí automaticky v MFC aplikace, které pomocí technologie ActiveX, automatizace OLE, OLE propojování nebo vkládání nebo ODBC nebo DAO operací.