Estrutura NMHDDISPINFOW (commctrl.h)

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

Sintaxe

typedef struct tagNMHDDISPINFOW {
  NMHDR  hdr;
  int    iItem;
  UINT   mask;
  LPWSTR pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} NMHDDISPINFOW, *LPNMHDDISPINFOW;

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

iImage

Tipo: int

O índice baseado em zero de uma imagem dentro da lista de imagens. A imagem especificada será exibida com o item de cabeçalho, mas não assumirá 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

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