Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Enviado por um controle de exibição de lista para notificar suas janelas pai sobre operações de desenho. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY .
NM_CUSTOMDRAW
lpNMCustomDraw = (LPNMLVCUSTOMDRAW) lParam;
Parâmetros
-
lParam
-
Ponteiro para uma estrutura NMLVCUSTOMDRAW que contém informações sobre a operação de desenho. O primeiro membro dessa estrutura, nmcd, é um ponteiro para uma estrutura NMCUSTOMDRAW . O membro dwItemSpec da estrutura apontada pelo nmcd contém o identificador do item que está sendo desenhado e o membro lItemlParam contém seus dados definidos pelo aplicativo.
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 desenhará a si mesmo. Ele não enviará nenhum código de notificação de NM_CUSTOMDRAW adicional para esse ciclo de pintura. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT. |
|
Windows Vista. O controle pintará apenas a tela de fundo. |
|
O controle notificará o pai de quaisquer operações de desenho relacionadas a itens. Ele enviará NM_CUSTOMDRAW códigos de notificação antes e depois de desenhar itens. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT. |
|
O controle notificará o pai depois de apagar um item. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT. |
|
O controle notificará o pai depois de pintar um item. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT. |
|
O 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. |
|
Versão 4.71. Seu aplicativo receberá um código de controle NM_CUSTOMDRAW com dwDrawStage definido como CDDS_ITEMPREPAINT | CDDS_SUBITEM antes de cada subitem de exibição de lista ser desenhado. Em seguida, você pode especificar fonte e cor para cada subitem separadamente ou retornar CDRF_DODEFAULT para processamento padrão. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT. |
|
O aplicativo desenhou o item manualmente. O controle não desenhará o item. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT. |
|
Windows Vista. O controle não desenhará o retângulo de foco. |
Comentários
Versão 5.80. Se você alterar a fonte retornando CDRF_NEWFONT, o controle de exibição de lista 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 lista, 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 |
|