ListView_SetBkImage Makro (commctrl.h)
Legt das Hintergrundbild in einem Listenansicht-Steuerelement fest. Sie können dieses Makro verwenden oder die LVM_SETBKIMAGE Nachricht explizit senden.
Syntax
BOOL ListView_SetBkImage(
HWND hwnd,
LPLVBKIMAGE plvbki
);
Parameter
hwnd
Typ: HWND-
Ein Handle für das Listenansicht-Steuerelement.
plvbki
Typ: LPLVBKIMAGE
Ein Zeiger auf eine LVBKIMAGE- Struktur, die die neuen Hintergrundbildinformationen enthält.
Rückgabewert
Typ: BOOL-
Gibt "nonzero" zurück, wenn dies erfolgreich ist, oder 0 andernfalls null. Gibt Null zurück, wenn das ulFlags-Element der LVBKIMAGE- Struktur LVBKIF_SOURCE_NONE ist.
Bemerkungen
Da das Listenansichtssteuerelement OLE COM verwendet, um die Hintergrundbilder zu bearbeiten, muss die aufrufende Anwendung CoInitialize oder OleInitialize aufrufen, bevor Sie dieses Makro verwenden. Es empfiehlt sich, eine dieser Funktionen aufzurufen, wenn die Anwendung initialisiert wird, und entweder CoUninitialize oder OleUninitialize aufrufen, wenn die Anwendung beendet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | commctrl.h |