Estrutura NMHEADERA (commctrl.h)

Contém informações sobre mensagens de notificação de controle de cabeçalho. Essa estrutura substitui a estrutura HD_NOTIFY .

Sintaxe

typedef struct tagNMHEADERA {
  NMHDR   hdr;
  int     iItem;
  int     iButton;
  HDITEMA *pitem;
} NMHEADERA, *LPNMHEADERA;

Membros

hdr

Tipo: NMHDR

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

iItem

Tipo: int

O índice baseado em zero do item de cabeçalho que é o foco da mensagem de notificação.

iButton

Tipo: int

Um valor que especifica o índice do botão do mouse usado para gerar a mensagem de notificação. Esse membro pode ser um dos seguintes valores:

Valor	Significado
0	Botão esquerdo
1	Botão direito
2	Botão Do meio

pitem

Tipo: HDITEM*

Um ponteiro opcional para uma estrutura HDITEM que contém informações sobre o item especificado por iItem. O membro mask da estrutura HDITEM indica quais de seus membros são válidos.

Comentários

Embora a maioria das notificações de controle de cabeçalho passe um ponteiro para uma estrutura NMHEADER , apenas algumas delas usam o membro pitem para passar uma estrutura HDITEM . Aqueles que usam pitem podem não fornecer informações completas sobre o item. Para obter mais informações sobre um item, use HDM_GETITEM.

Observação

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