NM_CUSTOMDRAW código de notificação (barra de ferramentas)

  • Artigo

Enviado por uma barra de ferramentas 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 = (LPNMCUSTOMDRAW) lParam;

Parâmetros

lParam

Versão 4.70. Ponteiro para uma estrutura NMCUSTOMDRAW que contém informações sobre a operação de desenho. O membro dwItemSpec dessa estrutura contém o identificador de comando do item que está sendo desenhado. O membro lItemlParam dessa estrutura contém o valor dwData para o item que está sendo desenhado.

Versão 4.71. Ponteiro para uma estrutura NMTBCUSTOMDRAW que contém informações sobre a operação de desenho. O membro dwItemSpec do membro nmcd dessa estrutura contém o identificador de comando do item que está sendo desenhado. O membro lItemlParam do membro nmcd dessa estrutura contém o valor dwData para o 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 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.
CDRF_NOTIFYITEMDRAW
 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.
CDRF_NOTIFYPOSTERASE
 O controle notificará o pai depois de apagar um item. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT.
CDRF_NOTIFYPOSTPAINT
 O controle notificará o pai depois de pintar um item. Isso ocorre quando dwDrawStage é igual a CDDS_PREPAINT.
CDRF_NOTIFYSUBITEMDRAW
 Versão 4.71. O controle notificará o pai quando um subitem de exibição de lista estiver 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.
TBCDRF_BLENDICON
 Versão 5.00. Misture o botão 50% com a tela de fundo. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT.
TBCDRF_NOBACKGROUND
 Versão 5.00. Não desenhe a tela de fundo do botão. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT.
TBCDRF_NOEDGES
 Versão 4.71. Não desenhe bordas de botão. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT.
TBCDRF_HILITEHOTTRACK
 Versão 4.71. Use o membro clrHighlightHotTrack da estrutura NMTBCUSTOMDRAW para desenhar a tela de fundo de itens com acompanhamento frequente. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT.
TBCDRF_NOOFFSET
 Versão 4.71. Não deslocar o botão quando pressionado. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT.
TBCDRF_NOMARK
 Não desenhe o realce padrão de itens que têm o TBSTATE_MARKED. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT.
TBCDRF_NOETCHEDEFFECT
 Versão 4.71. Não desenhe o efeito gravado para itens desabilitados. Isso ocorre quando dwDrawStage é igual a CDDS_ITEMPREPAINT.
TBCDRF_USECDCOLORS
 Versão 6.00, somente Windows Vista . Use cores de desenho personalizadas para renderizar texto, independentemente do estilo visual.

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