Structure LVBKIMAGEW (commctrl.h)

Article
08/22/2023

Contient des informations sur l’image d’arrière-plan d’un contrôle d’affichage de liste. Cette structure est utilisée pour définir et récupérer des informations d’image d’arrière-plan.

Syntaxe

typedef struct tagLVBKIMAGEW {
  ULONG   ulFlags;
  HBITMAP hbm;
  LPWSTR  pszImage;
  UINT    cchImageMax;
  int     xOffsetPercent;
  int     yOffsetPercent;
} LVBKIMAGEW, *LPLVBKIMAGEW;

Membres

ulFlags

Type : ULONG

Ce membre peut être un ou plusieurs des indicateurs suivants. Vous pouvez utiliser la valeur LVBKIF_SOURCE_MASK pour masquer tous les indicateurs sources sauf. Vous pouvez utiliser la valeur LVBKIF_STYLE_MASK pour masquer tous les indicateurs de style sauf.

Valeur	Signification
LVBKIF_SOURCE_NONE	Le contrôle d’affichage de liste n’a pas d’image d’arrière-plan.
LVBKIF_SOURCE_HBITMAP	Une bitmap d’arrière-plan est fournie via le membre hbm de LVBKIMAGE. Si le message LVM_SETBKIMAGE réussit, l’affichage de liste prend la propriété de la bitmap.
LVBKIF_SOURCE_URL	Le membre pszImage contient l’URL de l’image d’arrière-plan.
LVBKIF_STYLE_NORMAL	L’image d’arrière-plan s’affiche normalement.
LVBKIF_STYLE_TILE	L’image d’arrière-plan est en mosaïque pour remplir tout l’arrière-plan du contrôle.
LVBKIF_FLAG_TILEOFFSET	Spécifiez les coordonnées de la première vignette. Cet indicateur est valide uniquement si l’indicateur LVBKIF_STYLE_TILE est également spécifié. Si cet indicateur n’est pas spécifié, la première vignette commence dans le coin supérieur gauche de la zone cliente. Si vous utilisez ComCtl32.dll version 6.0 , les champs xOffsetPercent et yOffsetPercent contiennent des pixels, et non des valeurs de pourcentage, pour spécifier les coordonnées de la première vignette. Comctl32.dll version 6 n’est pas redistribuable, mais elle est incluse dans Windows ou une version ultérieure. En outre, vous devez spécifier Comctl32.dll version 6 dans un manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.
LVBKIF_TYPE_WATERMARK	Une bitmap d’arrière-plan en filigrane est fournie via le membre hbm de LVBKIMAGE. Si le message LVM_SETBKIMAGE réussit, le contrôle d’affichage de liste prend la propriété de la bitmap.
LVBKIF_FLAG_ALPHABLEND	Valide uniquement lorsque LVBKIF_TYPE_WATERMARK est également spécifié. Cet indicateur indique la bitmap fournie via LVBKIF_TYPE_WATERMARK contient un canal alpha valide.

hbm

Type : HBITMAP

Handle de l’image bitmap d’arrière-plan. Ce membre est valide uniquement si l’indicateur LVBKIF_SOURCE_HBITMAP est défini dans ulFlags.

pszImage

Type : LPTSTR

Adresse d’une chaîne terminée par NULL qui contient l’URL de l’image d’arrière-plan. Ce membre est valide uniquement si l’indicateur LVBKIF_SOURCE_URL est défini dans ulFlags. Ce membre doit être initialisé pour pointer vers la mémoire tampon qui contient ou reçoit le texte avant d’envoyer le message.

cchImageMax

Type : UINT

Taille de la mémoire tampon à l’adresse dans pszImage. Si des informations sont envoyées au contrôle, ce membre est ignoré.

xOffsetPercent

Type : int

Pourcentage de la zone cliente du contrôle que l’image doit être décalée horizontalement. Par exemple, à 0 %, l’image s’affiche sur le bord gauche de la zone cliente du contrôle. À 50 %, l’image est affichée horizontalement centrée dans la zone cliente du contrôle. À 100 %, l’image s’affiche sur le bord droit de la zone cliente du contrôle. Ce membre est valide uniquement lorsque LVBKIF_STYLE_NORMAL est spécifié dans ulFlags. Si LVBKIF_FLAG_TILEOFFSET et LVBKIF_STYLE_TILE sont spécifiés dans ulFlags, la valeur spécifie le pixel, et non le décalage en pourcentage, de la première vignette. Sinon, la valeur est ignorée.

yOffsetPercent

Type : int

Pourcentage de la zone cliente du contrôle que l’image doit être décalée verticalement. Par exemple, à 0 %, l’image s’affiche sur le bord supérieur de la zone cliente du contrôle. À 50 %, l’image est affichée verticalement centrée dans la zone cliente du contrôle. À 100 %, l’image est affichée sur le bord inférieur de la zone cliente du contrôle. Ce membre est valide uniquement lorsque LVBKIF_STYLE_NORMAL est spécifié dans ulFlags. Si LVBKIF_FLAG_TILEOFFSET et LVBKIF_STYLE_TILE sont spécifiés dans ulFlags, la valeur spécifie le pixel, et non le décalage en pourcentage, de la première vignette. Sinon, la valeur est ignorée.

Remarques

Cette structure est utilisée avec les messages LVM_GETBKIMAGE et LVM_SETBKIMAGE .

Notes

L’en-tête commctrl.h définit LVBKIMAGE en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	commctrl.h

Partager via