Estrutura NMTBCUSTOMDRAW (commctrl.h)

Contém informações específicas para um código de notificação NM_CUSTOMDRAW enviado por um controle de barra de ferramentas.

Sintaxe

typedef struct _NMTBCUSTOMDRAW {
  NMCUSTOMDRAW nmcd;
  HBRUSH       hbrMonoDither;
  HBRUSH       hbrLines;
  HPEN         hpenLines;
  COLORREF     clrText;
  COLORREF     clrMark;
  COLORREF     clrTextHighlight;
  COLORREF     clrBtnFace;
  COLORREF     clrBtnHighlight;
  COLORREF     clrHighlightHotTrack;
  RECT         rcText;
  int          nStringBkMode;
  int          nHLStringBkMode;
  int          iListGap;
} NMTBCUSTOMDRAW, *LPNMTBCUSTOMDRAW;

Membros

nmcd

Tipo: NMCUSTOMDRAW

Estrutura NMCUSTOMDRAW que contém informações gerais de desenho personalizado. O membro uItemState dessa estrutura pode ser modificado para que um item da barra de ferramentas seja desenhado no estado especificado sem realmente alterar o estado do item.

hbrMonoDither

Tipo: HBRUSH

HBRUSH que o controle usará ao desenhar a tela de fundo de itens marcados ou dithered. Esse membro será ignorado se TBCDRF_NOMARK for retornado do código de notificação NM_CUSTOMDRAW .

hbrLines

Tipo: HBRUSH

HBRUSH que o controle usará ao desenhar linhas nos botões.

hpenLines

Tipo: HPEN

HPEN que o controle usará ao desenhar linhas nos botões.

clrText

Tipo: COLORREF

COLORREF que representa a cor que o controle usará ao desenhar texto em itens normais.

clrMark

Tipo: COLORREF

COLORREF que representa a cor da tela de fundo que o controle usará ao desenhar texto em itens marcados.

clrTextHighlight

Tipo: COLORREF

COLORREF que representa a cor que o controle usará ao desenhar texto em itens realçados.

clrBtnFace

Tipo: COLORREF

COLORREF que representa a cor do rosto que o controle usará ao desenhar botões.

clrBtnHighlight

Tipo: COLORREF

COLORREF que representa a cor do rosto que o controle usará ao desenhar itens realçados. Um item será realçado se tiver o estilo TBSTATE_MARKED e estiver contido em uma barra de ferramentas que tenha o estilo TBSTYLE_FLAT .

clrHighlightHotTrack

Tipo: COLORREF

COLORREF que representa a cor da tela de fundo que o controle usará ao desenhar texto em itens com acompanhamento frequente. Esse membro será ignorado se TBCDRF_HILITEHOTTRACK não for retornado do código de notificação NM_CUSTOMDRAW .

rcText

Tipo: RECT

Estrutura RECT que, na entrada, contém o retângulo do texto do item. Os membros direito e inferior dessa estrutura podem ser modificados para alterar a largura e a altura, respectivamente, do retângulo de texto do item.

nStringBkMode

Tipo: int

Modo de tela de fundo que o controle usará ao desenhar o texto de um item não realçado. Pode ser o valor TRANSPARENT ou OPAQUE.

nHLStringBkMode

Tipo: int

Modo de tela de fundo que o controle usará ao desenhar o texto de um item realçado. Pode ser o valor TRANSPARENT ou OPAQUE.

iListGap

Tipo: int

Versão 6.0 Especifica a distância entre a imagem do botão de barra de ferramentas e o texto, em pixels lógicos, para barras de ferramentas que têm TBSTYLE_LIST conjunto de estilos.

Observe que Comctl32.dll versão 6 não é redistribuível, mas está incluído no Windows ou posterior. Para usar Comctl32.dll versão 6, especifique-a em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

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