Compartir a través de

código de notificación de NM_CUSTOMDRAW (vista de árbol)

  • Artículo

Enviado por un control de vista de árbol para notificar a su ventana primaria sobre las operaciones de dibujo. Este código de notificación se envía en forma de mensaje WM_NOTIFY .

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMTVCUSTOMDRAW) lParam;

Parámetros

lParam

Puntero a una estructura NMTVCUSTOMDRAW que contiene y recibe información sobre la operación de dibujo. El miembro dwItemSpec del miembro nmcd de esta estructura contiene el identificador del elemento que se va a dibujar. El miembro lItemlParam del miembro nmcd de esta estructura contiene el lParam del elemento que se dibuja.

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 dibuja a sí mismo. No envía ningún código de NM_CUSTOMDRAW adicional para este ciclo de pintura. Esto ocurre cuando dwDrawStage es igual a CDDS_PREPAINT.
CDRF_NOTIFYITEMDRAW
 El control notifica al elemento primario de las operaciones de dibujo relacionadas con elementos. Envía 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 notifica al elemento primario después de borrar un elemento. Esto ocurre cuando dwDrawStage es igual a CDDS_PREPAINT.
CDRF_NOTIFYPOSTPAINT
 El control notifica al elemento primario después de pintar un elemento. Esto ocurre cuando dwDrawStage es igual a CDDS_PREPAINT.
CDRF_NOTIFYSUBITEMDRAW
 Versión 4.71. El control notifica al elemento primario cuando se dibuja un subelemento de vista de lista. 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_SKIPDEFAULT
 La aplicación ha dibujado el elemento manualmente. El control no dibujará el elemento. Esto ocurre cuando dwDrawStage es igual a CDDS_ITEMPREPAINT.

Comentarios

Versión 5.80. Si cambia la fuente devolviendo CDRF_NEWFONT, el control de vista de árbol 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 árbol, 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

Consulte también

Uso de Dibujo personalizado