Estrutura NMTBDISPINFOW (commctrl.h)

  • Artigo

Contém e recebem informações de exibição para um item de 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;
  LPWSTR    pszText;
  int       cchText;
} NMTBDISPINFOW, *LPNMTBDISPINFOW;

Membros

hdr

Tipo: NMHDR

Estrutura 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. Esse 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 iImage .
TBNF_TEXT
 Não implementado atualmente.
TBNF_DI_SETITEM
 Defina esse sinalizador ao processar TBN_GETDISPINFO; o controle da barra de ferramentas reterá 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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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