Condividi tramite


CListCtrl::SetBkImage

L'immagine di sfondo di un controllo visualizzazione elenco.

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

Parametri

  • plvbkImage
    Indirizzo di una struttura LVBKIMAGE, contenente le nuove informazioni di un'immagine di sfondo.

  • hbm
    Handle a una bitmap.

  • pszUrl
    Una stringa con terminazione null contenente l'url dell'immagine di sfondo.

  • fTile
    Diverso da zero se l'immagine è necessario affiancata in background del controllo visualizzazione elenco, in caso contrario 0.

  • xOffsetPercent
    L'offset, in pixel, del bordo sinistro dell'immagine, dall'origine del controllo visualizzazione elenco.

  • yOffsetPercent
    L'offset, in pixel, del margine superiore dell'immagine, dall'origine del controllo visualizzazione elenco.

Valore restituito

Restituisce diverso da zero se l'operazione riesce, o zero in caso contrario.

Note

Nota

Poiché CListCtrl::SetBkImage utilizza la funzionalità COM OLE, le librerie OLE devono essere inizializzati prima di utilizzare SetBkImage.È consigliabile inizializzare le librerie COM quando l'applicazione viene inizializzata e uninitialize le librerie quando l'applicazione viene chiusa.Ciò viene fatto automaticamente nelle applicazioni MFC che utilizzano la tecnologia ActiveX, automazione OLE, collegare/per l'incorporamento OLE, o nelle operazioni di ODBC/DAO.

Esempio

Vedere l'esempio relativo CListCtrl::GetBkImage.

Requisiti

Header: afxcmn.h

Vedere anche

Riferimenti

Classe CListCtrl

Grafico delle gerarchie

CListCtrl::GetBkImage