Estrutura NMHDDISPINFOA (commctrl.h)

  • Artigo

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

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 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 que especifica 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 para o qual pszText aponta.

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.

Comentários

Observação

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 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

   
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