Estructura NMCUSTOMDRAW

Definición

typedef struct tagNMCUSTOMDRAWINFO {
  NMHDR     hdr;
  DWORD     dwDrawStage;
  HDC       hdc;
  RECT      rc;
  DWORD_PTR dwItemSpec;
  UINT      uItemState;
  LPARAM    lItemlParam;
} NMCUSTOMDRAW, *LPNMCUSTOMDRAW;

Contiene información específica para un código de notificación NM_CUSTOMDRAW.

Descripción

hdr

Una estructura NMHDR que contiene información sobre el código de notificación.

dwDrawStage

La etapa de dibujado actual. Este parámetro puede tener uno de los siguientes valores:

Valor	Significado
Valores globales:
CDDS_POSTERASE	Termina después del ciclo de borrado.
CDDS_POSTPAINT	Termina después del ciclo de pintado.
CDDS_PREERASE	Comienza antes del ciclo de borrado.
CDDS_PREPAINT	Comienza antes del ciclo de pintado.
Valores específicos de ítem:
CDDS_ITEM	Indica que los miembros dwItemSpec, uItemState, y lItemlParam son válidos.
CDDS_ITEMPOSTERASE	Después de que un ítem ha sido borrado.
CDDS_ITEMPOSTPAINT	Después de que un ítem ha sido dibujado.
CDDS_ITEMPREERASE	Antes de que un ítem sea borrado.
CDDS_ITEMPREPAINT	Antes de que un ítem sea dibujado.
CDDS_SUBITEM	Versión 4.71. Bandera combinada con CDDS_ITEMPREPAINT o CDDS_ITEMPOSTPAINT si un subítem está siendo dibujado. Este sólo será asignado su se retorna CDRF_NOTIFYITEMDRAW desde CDDS_PREPAINT.

hdc

Un manipulador al contexto de dispositivo del control. Usar este HDC para llevar a cabo cualquier función GDI.

rc

Estructura RECT que describe el rectángulo delimitador del área que se está dibujando. Este miembro es inicializado sólo por la notificación CDDS_ITEMPREPAINT. Desde la versión 5.80, este miembro también es inicializado por la notificación CDDS_PREPAINT.

dwItemSpec

El número de ítem. Lo que contenga este miembro dependerá del tipo de control que está enviando la notificación. Ver la referencia de la notificación NM_CUSTOMDRAW para el control específico para determinar qué, si hay algo, contiene este meimbro.

uItemState

El estado actual del ítem. Este valor es una combinación de las siguientes banderas.

Valor	Significado
CDIS_CHECKED	El ítem está marcado (checked).
CDIS_DEFAULT	El ítem está en su estado por defecto.
CDIS_DISABLED	El ítem está deshabilitado.
CDIS_FOCUS	El ítem tiene el foco.
CDIS_GRAYED	El ítem está inhibido (grayed).
CDIS_HOT	El ítem está actualmenta bajo el puntero ("hot").
CDIS_INDETERMINATE	El ítem está en un estado indeterminado.
CDIS_MARKED	El ítem está marcado. El significado de esta marca se determina por la implementación.
CDIS_SELECTED	El ítem está seleccionado. Nota: esta bandera no funciona correctamente para controles list-view owner-draw que tengan el estilo LVS_SHOWSELALWAYS. Para esos controles, se puede determinar si un ítem está seleccionado usando LVM_GETITEMSTATE (o ListView_GetItemState) y verificando la bandera LVIS_SELECTED.
CDIS_SHOWKEYBOARDCUES	Versión 6.0. El ítem está mostrando sus señales de teclado. Tener en cuenta que la versión 6 de Comctl32 no es redistribuible, pero está incluida con la versión Windows XP o sistemas operativos posteriores. Para usar la versión 6 de Comctl32.dll, especificarla en el manifiesto.
CDIS_NEARHOT	El ítem es parte de un control que está actualmente bajo el puntero del ratón ("hot"), pero el ítem no est'a "hot". El significado de esto se determina por la implementación.
CDIS_OTHERSIDEHOT	El ítem es parte de un splitbutton que está actualmente bajo el puntero del ratón ("hot"), pero el propio ítem no está "hot". El significado de esto depende de la implementación.
CDIS_DROPHILITED	El ítem es actualmente el objetivo de un arrastre en una operación de drag-and-drop.

lItemlParam

Dato de ítem definido por la aplicación.

Observaciones

El valor que la aplicación retorna depende de la etapa actual de dibujado. El meimbro dwDrawStage de la estructura NMCUSTOMDRAW asociada mantiene un valor que especifica la etapa de dibujado. Cuando el miembro dwDrawStage es igual a CDDS_PREPAINT y CDDS_PREERASE, algunos controles envían el mensaje CDDS_PREERASE preimero y esperan el valor de retorno que indique que mensajes subsiguientes serán enviados.