Structure LVBKIMAGEA (commctrl.h)

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 tagLVBKIMAGEA {
  ULONG   ulFlags;
  HBITMAP hbm;
  LPSTR   pszImage;
  UINT    cchImageMax;
  int     xOffsetPercent;
  int     yOffsetPercent;
} LVBKIMAGEA, *LPLVBKIMAGEA;

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, mais les indicateurs sources. Vous pouvez utiliser la valeur LVBKIF_STYLE_MASK pour masquer tous, mais les indicateurs de style.

Valeur	Signification
LVBKIF_SOURCE_NONE	Le contrôle d’affichage liste n’a aucune 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 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 sera mosaïque pour remplir l’arrière-plan entier 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 en haut à gauche de la zone cliente. Si vous utilisez ComCtl32.dll version 6.0 les xOffsetPer cent et champs yOffsetPercentPercent 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 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 de 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 la bitmap d’arrière-plan. Ce membre n’est valide que 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 pour cent, l’image s’affiche horizontalement centrée dans la zone cliente du contrôle. À 100 pour cent, 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 les LVBKIF_FLAG_TILEOFFSET et les LVBKIF_STYLE_TILE sont spécifiés dans ulFlags, la valeur spécifie le pixel, et non le décalage de 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 pour cent, l’image s’affiche sur le bord supérieur de la zone cliente du contrôle. À 50 pour cent, l’image s’affiche verticalement centrée dans la zone cliente du contrôle. À 100 %, l’image s’affiche 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 les LVBKIF_FLAG_TILEOFFSET et les LVBKIF_STYLE_TILE sont spécifiés dans ulFlags, la valeur spécifie le pixel, et non le décalage de 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.

Note

L’en-tête commctrl.h définit LVBKIMAGE comme 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. Le mélange 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.

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]
d’en-tête	commctrl.h