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 de 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. A máscara de membro da estrutura HDITEM indica quais de seus membros são válidos.

Observações

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.

Nota

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