Compartilhar via

Estrutura NMHDDISPINFOA (commctrl.h)

  • Artigo

Contém informações usadas no tratamento de códigos de notificação HDN_GETDISPINFO.

Sintaxe

typedef struct tagNMHDDISPINFOA {
  NMHDR  hdr;
  int    iItem;
  UINT   mask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} NMHDDISPINFOA, *LPNMHDDISPINFOA;

Membros

hdr

Tipo: NMHDR

estrutura de NMHDR que contém informações sobre esse código de notificação.

iItem

Tipo: int

O índice baseado em zero do item no controle de cabeçalho.

mask

Tipo: UINT

Um conjunto de sinalizadores de bits especificando quais membros da estrutura devem ser preenchidos pelo proprietário do controle de cabeçalho. Esse valor pode ser uma combinação dos seguintes valores:

Valor Significado
HDI_TEXT
 O campo pszText deve ser preenchido.
HDI_IMAGE

versão 4.70. O campo iImage deve ser preenchido.
HDI_LPARAM
 O campo lParam deve ser preenchido.
HDI_DI_SETITEM

versão 4.70. Um valor retornado. Indica que o controle de cabeçalho deve armazenar as informações do item e não solicitá-la novamente.

pszText

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto que será exibido para o item de cabeçalho.

cchTextMax

Tipo: int

O tamanho do buffer que pszText aponta para.

iImage

Tipo: int

O índice baseado em zero de uma imagem na lista de imagens. A imagem especificada será exibida com o item de cabeçalho, mas não tomará o lugar do bitmap do item. Se iImage estiver definido como I_IMAGECALLBACK, o controle solicitará informações de imagem para esse item usando um código de notificação HDN_GETDISPINFO.

lParam

Tipo: LPARAM

Um valor definido pelo aplicativo a ser associado ao item.

Observações

Nota

O cabeçalho commctrl.h define NMHDDISPINFO 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