NMHDDISPINFOW-Struktur (commctrl.h)

  • Artikel

Enthält Informationen, die bei der Verarbeitung HDN_GETDISPINFO Benachrichtigungscodes verwendet werden.

Syntax

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

Member

hdr

Typ: NMHDR

NMHDR-Struktur mit Informationen zu diesem Benachrichtigungscode.

iItem

Typ: int

Der nullbasierte Index des Elements im Headersteuerelement.

mask

Typ: UINT

Eine Reihe von Bitflags, die angeben, welche Elemente der Struktur vom Besitzer des Headersteuerelements ausgefüllt werden müssen. Dieser Wert kann eine Kombination der folgenden Werte sein:

Wert Bedeutung
HDI_TEXT
 Das Feld pszText muss ausgefüllt werden.
HDI_IMAGE

Version 4.70. Das Feld iImage muss ausgefüllt werden.
HDI_LPARAM
 Das Feld lParam muss ausgefüllt werden.
HDI_DI_SETITEM

Version 4.70. Ein Rückgabewert. Gibt an, dass das Headersteuerelement die Elementinformationen speichern und nicht erneut anfordern soll.

pszText

Typ: LPTSTR

Ein Zeiger auf eine NULL-Zeichenfolge, die den Text enthält, der für das Headerelement angezeigt wird.

cchTextMax

Typ: int

Die Größe des Puffers, auf den pszText verweist.

iImage

Typ: int

Der nullbasierte Index eines Bilds innerhalb der Bildliste. Das angegebene Bild wird mit dem Kopfzeilenelement angezeigt, tritt jedoch nicht an die Stelle der Bitmap des Elements. Wenn iImage auf I_IMAGECALLBACK festgelegt ist, fordert das Steuerelement Mithilfe eines HDN_GETDISPINFO Benachrichtigungscodes Bildinformationen für dieses Element an.

lParam

Typ: LPARAM

Ein anwendungsdefinierter Wert, der dem Element zugeordnet werden soll.

Hinweise

Hinweis

Der commctrl.h-Header definiert NMHDDISPINFO 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