Partager via


CListCtrl::SetBkImage

Définit l'image d'arrière-plan d'un contrôle liste view.

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

Paramètres

  • plvbkImage
    Adresse d'une structure de LVBKIMAGE , contenant les nouvelles informations d'image d'arrière-plan.

  • hbm
    Handle à une bitmap.

  • pszUrl
    NULL- Chaîne terminée qui contient l'URL de l'image d'arrière-plan.

  • fTile
    Une valeur différente de zéro si l'image doit être supprimée en mosaïque en arrière-plan du contrôle liste view ; sinon 0.

  • xOffsetPercent
    L'offset, en pixels, du bord gauche de l'image, l'origine du contrôle liste view.

  • yOffsetPercent
    L'offset, en pixels, du bord supérieur de l'image, l'origine du contrôle liste view.

Valeur de retour

Retourne une valeur différente de zéro en cas de réussite, ou zéro sinon.

Notes

[!REMARQUE]

Étant donné qu' CListCtrl::SetBkImage se sert de OLE fonctionnalités de COM, OLE les bibliothèques doivent être initialisées avant d'utiliser SetBkImage.Il est préférable d'initialiser les bibliothèques COM lorsque l'application est initialisée et uninitialize les bibliothèques lorsque l'application se termine.Cela est fait automatiquement dans les applications MFC qui se servent de la technologie ActiveX, OLE Automation, la liaison d'incorporation OLE/, ou les opérations d'ODBC/DAO.

Exemple

Consultez l'exemple pour CListCtrl::GetBkImage.

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

Classe de CListCtrl

Graphique de la hiérarchie

CListCtrl::GetBkImage