NMLVCUSTOMDRAW, structure (commctrl.h)

Contient des informations spécifiques à un code de notification NM_CUSTOMDRAW (affichage liste) envoyé par un contrôle d’affichage de liste.

Syntaxe

typedef struct tagNMLVCUSTOMDRAW {
  NMCUSTOMDRAW nmcd;
  COLORREF     clrText;
  COLORREF     clrTextBk;
  int          iSubItem;
  DWORD        dwItemType;
  COLORREF     clrFace;
  int          iIconEffect;
  int          iIconPhase;
  int          iPartId;
  int          iStateId;
  RECT         rcText;
  UINT         uAlign;
} NMLVCUSTOMDRAW, *LPNMLVCUSTOMDRAW;

Members

nmcd

Type : NMCUSTOMDRAW

Structure NMCUSTOMDRAW qui contient des informations de dessin personnalisées générales.

clrText

Type : COLORREF

Valeur COLORREF représentant la couleur qui sera utilisée pour afficher le premier plan du texte dans le contrôle d’affichage de liste.

clrTextBk

Type : COLORREF

Valeur COLORREF représentant la couleur qui sera utilisée pour afficher l’arrière-plan du texte dans le contrôle d’affichage de liste. Dans la version 6.0., ce membre est ignoré si l’image d’arrière-plan est définie avec le message LVM_SETBKIMAGE .

iSubItem

Type : int

Version 4.71. Index du sous-élément qui est dessiné. Si l’élément principal est dessiné, ce membre est égal à zéro.

dwItemType

Type : DWORD

Version 6.0.   DWORD qui contient le type de l’élément à dessiner. Ce membre peut être l’une des valeurs suivantes.

Valeur Sens
LVCDI_ITEM
Un élément doit être dessiné.
LVCDI_GROUP
Un groupe doit être dessiné.
LVCDI_ITEMSLIST
Chaque élément doit être dessiné.

clrFace

Type : COLORREF

Version 6.0.Valeur COLORREF représentant la couleur qui sera utilisée pour afficher le visage d’un élément.

iIconEffect

Type : int

Version 6.0.  Valeur de type int qui spécifie l’effet appliqué à une icône, telle que Glow, Shadow ou Pulse.

iIconPhase

Type : int

Version 6.0.  Valeur de type int qui spécifie la phase d’une icône.

iPartId

Type : int

Version 6.0.  Valeur de type int qui spécifie l’ID de la partie d’un élément à dessiner.

iStateId

Type : int

Version 6.0.  Valeur de type int qui spécifie l’ID de l’état d’un élément à dessiner.

rcText

Type : RECT

Version 6.0.RECT qui spécifie le rectangle dans lequel le texte doit être dessiné.

uAlign

Type : UINT

Version 6.0.UINT qui spécifie la façon dont un groupe doit être aligné. Ce membre peut être l’une des valeurs suivantes.

Valeur Sens
LVGA_HEADER_CENTER
Centrez le groupe.
LVGA_HEADER_LEFT
Alignez le groupe sur la gauche.
LVGA_HEADER_RIGHT
Alignez le groupe à droite.

Remarques

Note Comctl32.dll version 6 n’est pas redistribuable, mais il est inclus dans Windows XP ou version ultérieure. Pour utiliser Comctl32.dll version 6, spécifiez-le dans un manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.
 

Exigences

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