Compartilhar via


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

Enviado por um controle trackbar 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 = (LPNMCUSTOMDRAW) lParam;

Parâmetros

lParam

Ponteiro para uma estrutura NMCUSTOMDRAW que contém informações sobre a operação de desenho. O membro dwItemSpec dessa estrutura conterá um dos Valores de Desenho Personalizados que indica qual parte do controle está sendo desenhada. Os controles trackbar inserem os seguintes valores no membro dwItemSpec dessa estrutura para identificar a parte do controle que está sendo desenhada:

Valor Significado
TBCD_CHANNEL
Identifica o canal ao qual o marcador de polegar do controle trackbar desliza.
TBCD_THUMB
Identifica o marcador de polegar do controle trackbar. Essa é a parte do controle que o usuário move.
TBCD_TICS
Identifica as marcas de escala de incremento que aparecem ao longo da borda do controle trackbar.

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.

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