Freigeben über

NMHDDISPINFOA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen zur Behandlung von HDN_GETDISPINFO Benachrichtigungscodes.

Syntax

typedef struct tagNMHDDISPINFOA {
  NMHDR  hdr;
  int    iItem;
  UINT   mask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} NMHDDISPINFOA, *LPNMHDDISPINFOA;

Angehörige

hdr

Typ: NMHDR-

NMHDR- Struktur, die Informationen zu diesem Benachrichtigungscode enthält.

iItem

Typ: int

Der nullbasierte Index des Elements im Kopfzeilensteuerelement.

mask

Typ: UINT-

Eine Gruppe von Bitkennzeichnungen, die angeben, welche Elemente der Struktur vom Besitzer des Headersteuerelements ausgefüllt werden müssen. Dieser Wert kann eine Kombination aus den folgenden Werten 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 Kopfzeilensteuerelement die Elementinformationen speichern und nicht erneut danach fragen soll.

pszText

Typ: LPTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Text enthält, der für das Kopfzeilenelement angezeigt wird.

cchTextMax

Typ: int

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

iImage

Typ: int

Der nullbasierte Index eines Bilds in der Bildliste. Das angegebene Bild wird mit dem Kopfzeilenelement angezeigt, nimmt jedoch nicht den Platz der Bitmap des Elements auf. Wenn iImage- auf I_IMAGECALLBACK festgelegt ist, fordert das Steuerelement Bildinformationen für dieses Element mithilfe eines HDN_GETDISPINFO Benachrichtigungscodes an.

lParam

Typ: LPARAM-

Ein anwendungsdefinierter Wert, der dem Element zugeordnet werden soll.

Bemerkungen

Anmerkung

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