código de notificación de NM_CUSTOMDRAW (vista de lista)

  • Artículo

Enviado por un control de vista de lista para notificar a sus ventanas primarias sobre las operaciones de dibujo. Este código de notificación se envía en forma de mensaje WM_NOTIFY .

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMLVCUSTOMDRAW) lParam;

Parámetros

lParam

Puntero a una estructura NMLVCUSTOMDRAW que contiene información sobre la operación de dibujo. El primer miembro de esta estructura, nmcd, es un puntero a una estructura NMCUSTOMDRAW . El miembro dwItemSpec de la estructura a la que apunta nmcd contiene el identificador del elemento que se dibuja y el miembro lItemlParam contiene sus datos definidos por la aplicación.

Valor devuelto

El valor que la aplicación puede devolver depende de la fase de dibujo actual. El miembro dwDrawStage de la estructura NMCUSTOMDRAW asociada contiene un valor que especifica la fase de dibujo. Debe devolver uno de los valores siguientes.

Código devuelto Descripción
CDRF_DODEFAULT
 El control se dibujará a sí mismo. No enviará ningún NM_CUSTOMDRAW códigos de notificación adicionales para este ciclo de pintura. Esto ocurre cuando dwDrawStage es igual a CDDS_PREPAINT.
CDRF_DOERASE
 Windows Vista. El control solo pintará el fondo.
CDRF_NOTIFYITEMDRAW
 El control notificará al elemento primario de las operaciones de dibujo relacionadas con elementos. Enviará NM_CUSTOMDRAW códigos de notificación antes y después de dibujar elementos. Esto ocurre cuando dwDrawStage es igual a CDDS_PREPAINT.
CDRF_NOTIFYPOSTERASE
 El control notificará al elemento primario después de borrar un elemento. Esto ocurre cuando dwDrawStage es igual a CDDS_PREPAINT.
CDRF_NOTIFYPOSTPAINT
 El control notificará al elemento primario después de pintar un elemento. Esto ocurre cuando dwDrawStage es igual a CDDS_PREPAINT.
CDRF_NEWFONT
 La aplicación especificó una nueva fuente para el elemento; el control usará la nueva fuente. Para obtener más información sobre cómo cambiar las fuentes, consulte Cambio de fuentes y colores. Esto ocurre cuando dwDrawStage es igual a CDDS_ITEMPREPAINT.
CDRF_NOTIFYSUBITEMDRAW
 Versión 4.71. La aplicación recibirá un código de control NM_CUSTOMDRAW con dwDrawStage establecido en CDDS_ITEMPREPAINT | CDDS_SUBITEM antes de dibujar cada subelemento de vista de lista. A continuación, puede especificar la fuente y el color de cada subelemento por separado o devolver CDRF_DODEFAULT para el procesamiento predeterminado. Esto ocurre cuando dwDrawStage es igual a CDDS_ITEMPREPAINT.
CDRF_SKIPDEFAULT
 La aplicación ha dibujado el elemento manualmente. El control no dibujará el elemento. Esto ocurre cuando dwDrawStage es igual a CDDS_ITEMPREPAINT.
CDRF_SKIPPOSTPAINT
 Windows Vista. El control no dibujará el rectángulo de foco.

Comentarios

Versión 5.80. Si cambia la fuente devolviendo CDRF_NEWFONT, el control de vista de lista podría mostrar texto recortado. Este comportamiento es necesario para la compatibilidad con versiones anteriores de los controles comunes. Si desea cambiar la fuente de un control de vista de lista, obtendrá mejores resultados si envía un mensaje de CCM_SETVERSION con el valor wParam establecido en 5 antes de agregar elementos al control.

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