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

Siehe auch

ListView_GetBkImage