CListCtrl::SetBkImage

Legt das Hintergrundbild eines Listenansicht-Steuerelements fest.

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

Parameter

plvbkImage
Adresse einer LVBKIMAGE-Struktur, die neuen Hintergrundbildinformationen enthalten.
hbm
Handle einer Bitmap.
pszUrl
NULL beendete Zeichenfolge, die die URL des Hintergrundbilds enthält.
fTile
ungleich 0 (null), wenn das Bild im Hintergrund des Listenansicht-Steuerelements angeordnet werden soll; andernfalls 0.
xOffsetPercent
Der Offset, in Pixel, des Bilds Rand, vom Ursprung des Listenansicht-Steuerelements gelassen.
yOffsetPercent
Der Offset, in Pixel, des oberen Rands des Bilds, vom Ursprung des Listenansicht-Steuerelements.

Rückgabewert

Gibt ungleich 0 (null), wenn erfolgreich oder null zurück; andernfalls.

Hinweise

Hinweis
Da CListCtrl::SetBkImage-Funktionalität OLE COM ausnutzt, vor der Verwendung von SetBkImage müssen die OLE-Bibliotheken initialisiert werden.Es empfiehlt sich, die COM-Bibliotheken zu initialisieren, wenn die Anwendung und Bibliotheken zu deinitialisieren initialisiert wird, wenn die Anwendung beendet wird.Dies wird automatisch in MFC-Anwendungen durchgeführt, die ActiveX-Technologie, OLE-Automatisierung, OLE Verknüpfen/" oder ODBC-/DAOvorgänge ausnutzen.

Da CListCtrl::SetBkImage-Funktionalität OLE COM ausnutzt, vor der Verwendung von SetBkImage müssen die OLE-Bibliotheken initialisiert werden.Es empfiehlt sich, die COM-Bibliotheken zu initialisieren, wenn die Anwendung und Bibliotheken zu deinitialisieren initialisiert wird, wenn die Anwendung beendet wird.Dies wird automatisch in MFC-Anwendungen durchgeführt, die ActiveX-Technologie, OLE-Automatisierung, OLE Verknüpfen/" oder ODBC-/DAOvorgänge ausnutzen.