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 les indicateurs sources sauf. Vous pouvez utiliser la valeur LVBKIF_STYLE_MASK pour masquer tous les indicateurs de style sauf.
Valeur | Signification |
---|---|
|
Le contrôle d’affichage de liste n’a pas d’image d’arrière-plan. |
|
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. |
|
Le membre pszImage contient l’URL de l’image d’arrière-plan. |
|
L’image d’arrière-plan s’affiche normalement. |
|
L’image d’arrière-plan est en mosaïque pour remplir tout l’arrière-plan du contrôle. |
|
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. |
|
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. |
|
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 |