NM_CUSTOMDRAW código de notificação (exibição de árvore)

Enviado por um controle de exibição de árvore para notificar sua janela pai sobre operações de desenho. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY .

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMTVCUSTOMDRAW) lParam;

Parâmetros

lParam

Ponteiro para uma estrutura NMTVCUSTOMDRAW que contém e recebe informações sobre a operação de desenho. O membro dwItemSpec do membro nmcd dessa estrutura contém o identificador do item que está sendo desenhado. O membro lItemlParam do membro nmcd dessa estrutura contém o lParam do item que está sendo desenhado.

Valor retornado

O valor que seu aplicativo pode retornar depende da fase de desenho atual. O membro dwDrawStage da estrutura NMCUSTOMDRAW associada contém um valor que especifica o estágio de desenho. Você deve retornar um dos valores a seguir.

Código de retorno	Descrição
CDRF_DODEFAULT	O controle desenha a si mesmo. Ele não envia nenhum código de NM_CUSTOMDRAW adicional para esse ciclo de pintura. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT.
CDRF_NOTIFYITEMDRAW	O controle notifica o pai de quaisquer operações de desenho relacionadas a itens. Ele envia NM_CUSTOMDRAW códigos de notificação antes e depois de desenhar itens. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT.
CDRF_NOTIFYPOSTERASE	O controle notifica o pai depois de apagar um item. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT.
CDRF_NOTIFYPOSTPAINT	O controle notifica o pai depois de pintar um item. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT.
CDRF_NOTIFYSUBITEMDRAW	Versão 4.71. O controle notifica o pai quando um subitem de exibição de lista está sendo desenhado. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT.
CDRF_NEWFONT	Seu aplicativo especificou uma nova fonte para o item; o controle usará a nova fonte. Para obter mais informações sobre como alterar fontes, consulte Alterando fontes e cores. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT.
CDRF_SKIPDEFAULT	Seu aplicativo desenhou o item manualmente. O controle não desenhará o item. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT.

Comentários

Versão 5.80. Se você alterar a fonte retornando CDRF_NEWFONT, o controle de exibição de árvore poderá exibir texto recortado. Esse comportamento é necessário para compatibilidade com versões anteriores dos controles comuns. Se você quiser alterar a fonte de um controle de exibição de árvore, obterá melhores resultados se enviar uma mensagem CCM_SETVERSION com o valor wParam definido como 5 antes de adicionar quaisquer itens ao controle.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Commctrl.h

Confira também

Usando o desenho personalizado