NMHEADERA-Struktur (commctrl.h)

Enthält Informationen zu Headersteuerelementbenachrichtigungen. Diese Struktur ersetzt die HD_NOTIFY-Struktur .

Syntax

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

Member

hdr

Typ: NMHDR

Eine NMHDR-Struktur , die Informationen zur Benachrichtigungsnachricht enthält.

iItem

Typ: int

Der nullbasierte Index des Kopfzeilenelements, das der Fokus der Benachrichtigungsnachricht ist.

iButton

Typ: int

Ein Wert, der den Index der Maustaste angibt, die zum Generieren der Benachrichtigungsnachricht verwendet wird. Dieser Member kann einer der folgenden Werte sein:

Wert	Bedeutung
0	Linke Schaltfläche
1	Schaltfläche "Rechts"
2	Mittlere Schaltfläche

pitem

Typ: HDITEM*

Ein optionaler Zeiger auf eine HDITEM-Struktur , die Informationen zu dem durch iItem angegebenen Element enthält. Das Maskenelement der HDITEM-Struktur gibt an, welche ihrer Elemente gültig sind.

Hinweise

Während die meisten Headersteuerelementbenachrichtigungen einen Zeiger auf eine NMHEADER-Struktur übergeben, verwenden nur einige von ihnen das Pitemelement , um eine HDITEM-Struktur zu übergeben. Diejenigen, die Pitem verwenden, liefern möglicherweise keine vollständigen Informationen über das Element. Um weitere Informationen zu einem Element zu erhalten, verwenden Sie HDM_GETITEM.

Hinweis

Der commctrl.h-Header definiert NMHEADER als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	commctrl.h