Freigeben über

NMHEADERA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen zu Benachrichtigungen über Kopfzeilensteuerelemente. Diese Struktur ersetzt die HD_NOTIFY Struktur.

Syntax

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

Angehörige

hdr

Typ: NMHDR-

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

iItem

Typ: int

Der nullbasierte Index des Kopfzeilenelements, das den Fokus der Benachrichtigungsnachricht darstellt.

iButton

Typ: int

Ein Wert, der den Index der Maustaste angibt, die zum Generieren der Benachrichtigung verwendet wird. Dieses Element kann einer der folgenden Werte sein:

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

pitem

Typ: HDITEM-*

Ein optionaler Zeiger auf eine HDITEM- Struktur, die Informationen über das durch iItem-angegebene Element enthält. Das Mask Mitglied der HDITEM- Struktur gibt an, welche elemente gültig sind.

Bemerkungen

Während die meisten Headersteuerelementbenachrichtigungen einen Zeiger an eine NMHEADER- Struktur übergeben, verwenden nur einige davon das Pitem Member, um eine HDITEM- Struktur zu übergeben. Diejenigen, die Pitem verwenden, enthalten möglicherweise keine vollständigen Informationen über das Element. Verwenden Sie HDM_GETITEM, um weitere Informationen zu einem Element zu erhalten.

Anmerkung

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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Header- commctrl.h