macro ListView_SetBkImage (commctrl.h)

Articolo
10/24/2024

Imposta l'immagine di sfondo in un controllo visualizzazione elenco. È possibile utilizzare questa macro o inviare il messaggio di LVM_SETBKIMAGE in modo esplicito.

Sintassi

BOOL ListView_SetBkImage(
   HWND        hwnd,
   LPLVBKIMAGE plvbki
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

plvbki

Tipo: LPLVBKIMAGE

Puntatore a una struttura LVBKIMAGE che contiene le nuove informazioni sull'immagine di sfondo.

Valore restituito

Tipo: BOOL

Restituisce un valore diverso da zero se ha esito positivo o zero in caso contrario. Restituisce zero se il membro ulFlags della struttura LVBKIMAGE è LVBKIF_SOURCE_NONE.

Osservazioni

Poiché il controllo visualizzazione elenco utilizza OLE COM per modificare le immagini di sfondo, l'applicazione chiamante deve chiamare CoInitialize o OleInitialize prima di utilizzare questa macro. È consigliabile chiamare una di queste funzioni quando l'applicazione viene inizializzata e chiamare CoUninitialize o OleUninitialize quando l'applicazione termina.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h

Vedere anche

ListView_GetBkImage

Condividi tramite