Partager via


macro ListView_SetBkImage (commctrl.h)

Définit l’image d’arrière-plan dans un contrôle d’affichage de liste. Vous pouvez utiliser cette macro ou envoyer explicitement le message LVM_SETBKIMAGE.

Syntaxe

BOOL ListView_SetBkImage(
   HWND        hwnd,
   LPLVBKIMAGE plvbki
);

Paramètres

hwnd

Type : HWND

Handle du contrôle list-view.

plvbki

Type : LPLVBKIMAGE

Pointeur vers une structure LVBKIMAGE qui contient les nouvelles informations d’image d’arrière-plan.

Valeur de retour

Type : BOOL

Retourne une valeur différente de zéro si elle réussit ou zéro dans le cas contraire. Renvoie zéro si le membre ulFlags de la structure LVBKIMAGE est LVBKIF_SOURCE_NONE.

Remarques

Étant donné que le contrôle d’affichage de liste utilise OLE COM pour manipuler les images d’arrière-plan, l’application appelante doit appeler CoInitialize ou OleInitialize avant d’utiliser cette macro. Il est préférable d’appeler l’une de ces fonctions lorsque l’application est initialisée et qu’elle appelle CoUninitialize ou OleUninitialize lorsque l’application se termine.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête commctrl.h

Voir aussi

ListView_GetBkImage