Structure NMLVCUSTOMDRAW (commctrl.h)

  • Article

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

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;

Membres

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 texte au premier plan 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 list-view. 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 en cours de dessin. Si l’élément main 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 Signification
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 Signification
LVGA_HEADER_CENTER
 Centrer le groupe.
LVGA_HEADER_LEFT
 Alignez le groupe à gauche.
LVGA_HEADER_RIGHT
 Alignez le groupe à droite.

Remarques

Notez Comctl32.dll version 6 n’est pas redistribuable, mais elle est incluse dans Windows ou une version ultérieure. Pour utiliser Comctl32.dll version 6, spécifiez-la dans un manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.
 

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