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 |
|---|---|
|
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. |
|
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. |
|
O controle notifica o pai depois de apagar um item. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT. |
|
O controle notifica o pai depois de pintar um item. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT. |
|
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. |
|
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. |
|
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 |
|