Compartilhar via

Estrutura NMTBDISPINFOA (commctrl.h)

  • Artigo

Contém e recebe informações de exibição para um item da barra de ferramentas. Essa estrutura é usada com o código de notificação TBN_GETDISPINFO.

Sintaxe

typedef struct {
  NMHDR     hdr;
  DWORD     dwMask;
  int       idCommand;
  DWORD_PTR lParam;
  int       iImage;
  LPSTR     pszText;
  int       cchText;
} NMTBDISPINFOA, *LPNMTBDISPINFOA;

Membros

hdr

Tipo: NMHDR

estrutura de NMHDR que contém informações adicionais sobre a notificação.

dwMask

Tipo: DWORD

Conjunto de sinalizadores que indicam quais membros dessa estrutura estão sendo solicitados. Isso pode ser um ou mais dos valores a seguir.

Valor Significado
TBNF_IMAGE
 O índice de imagem do item está sendo solicitado. O índice de imagem deve ser colocado no membro do iImage.
TBNF_TEXT
 Não implementado no momento.
TBNF_DI_SETITEM
 Definir esse sinalizador ao processar TBN_GETDISPINFO; o controle da barra de ferramentas manterá as informações fornecidas e não as solicitará novamente.

idCommand

Tipo: int

Identificador de comando do item para o qual as informações de exibição estão sendo solicitadas. Esse membro é preenchido pelo controle antes de enviar o código de notificação.

lParam

Tipo: DWORD_PTR

Valor definido pelo aplicativo associado ao item para o qual as informações de exibição estão sendo solicitadas. Esse membro é preenchido pelo controle antes de enviar o código de notificação.

iImage

Tipo: int

Índice de imagem para o item.

pszText

Tipo: LPTSTR

Ponteiro para um buffer de caracteres que recebe o texto do item.

cchText

Tipo: int

Tamanho do buffer pszText, em caracteres.

Observações

Nota

O cabeçalho commctrl.h define NMTBDISPINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho commctrl.h