Estructura NMLVCUSTOMDRAW (commctrl.h)

  • Artículo

Contiene información específica de un código de notificación de NM_CUSTOMDRAW (vista de lista) enviado por un control de vista de lista.

Sintaxis

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;

Miembros

nmcd

Tipo: NMCUSTOMDRAW

Estructura NMCUSTOMDRAW que contiene información general de dibujo personalizada.

clrText

Tipo: COLORREF

Valor COLORREF que representa el color que se usará para mostrar el primer plano del texto en el control de vista de lista.

clrTextBk

Tipo: COLORREF

Valor COLORREF que representa el color que se usará para mostrar el fondo de texto en el control de vista de lista. En la versión 6.0., este miembro se omite si la imagen de fondo se establece con el mensaje LVM_SETBKIMAGE .

iSubItem

Tipo: int

Versión 4.71. Índice del subelemento que se está dibujando. Si se dibuja el elemento principal, este miembro será cero.

dwItemType

Tipo: DWORD

Versión 6.0.   DWORD que contiene el tipo del elemento que se va a dibujar. Este miembro puede ser uno de los siguientes valores.

Valor Significado
LVCDI_ITEM
 Se va a dibujar un elemento.
LVCDI_GROUP
 Se va a dibujar un grupo.
LVCDI_ITEMSLIST
 Cada elemento se va a dibujar.

clrFace

Tipo: COLORREF

Versión 6.0.Valor COLORREF que representa el color que se usará para mostrar la cara de un elemento.

iIconEffect

Tipo: int

Versión 6.0.  Valor de tipo int que especifica el efecto que se aplica a un icono, como Glow, Shadow o Pulse.

iIconPhase

Tipo: int

Versión 6.0.  Valor de tipo int que especifica la fase de un icono.

iPartId

Tipo: int

Versión 6.0.  Valor de tipo int que especifica el identificador de la parte de un elemento que se va a dibujar.

iStateId

Tipo: int

Versión 6.0.  Valor de tipo int que especifica el identificador del estado de un elemento que se va a dibujar.

rcText

Tipo: RECT

Versión 6.0.RECT que especifica el rectángulo en el que se va a dibujar el texto.

uAlign

Tipo: UINT

Versión 6.0.UINT que especifica cómo se debe alinear un grupo. Este miembro puede ser uno de los siguientes valores.

Valor Significado
LVGA_HEADER_CENTER
 Centre el grupo.
LVGA_HEADER_LEFT
 Alinee el grupo a la izquierda.
LVGA_HEADER_RIGHT
 Alinee el grupo a la derecha.

Comentarios

Nota Comctl32.dll versión 6 no se puede redistribuir, pero se incluye en Windows o versiones posteriores. Para usar Comctl32.dll versión 6, especifíquelo en un manifiesto. Para obtener más información sobre los manifiestos, consulte Habilitación de estilos visuales.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado commctrl.h