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 di CListCtrl

Grafico della gerarchia

CListCtrl::GetBkImage