NMLVDISPINFOA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen zu einem LVN_GETDISPINFO oder LVN_SETDISPINFO Benachrichtigungscode. Diese Struktur entspricht der LV_DISPINFO-Struktur , wurde jedoch umbenannt, um den Standardbenennungskonventionen zu entsprechen.

Syntax

typedef struct tagLVDISPINFO {
  NMHDR   hdr;
  LVITEMA item;
} NMLVDISPINFOA, *LPNMLVDISPINFOA;

Member

hdr

Typ: NMHDR

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

item

Typ: LVITEM

LVITEM-Struktur , die das Element oder Unterelement identifiziert. Die Struktur enthält oder empfängt Informationen über das Element. Das Maskenelement enthält eine Reihe von Bitflags, die angeben, welche Elementattribute relevant sind. Weitere Informationen zu den verfügbaren Bitflags finden Sie unter LVITEM.

Hinweise

Wenn die LVITEM-Struktur Elementtext empfängt, geben die Elemente pszText und cchTextMax die Adresse und Größe eines Puffers an. Sie können entweder Text in den Puffer kopieren oder dem pszText-Member die Adresse einer Zeichenfolge zuweisen. Im letzteren Fall dürfen Sie die Zeichenfolge erst ändern oder löschen, wenn der entsprechende Elementtext gelöscht oder zwei zusätzliche LVN_GETDISPINFO Nachrichten gesendet wurden.

Wenn Sie die LVN_GETDISPINFO Nachricht behandeln, können Sie das LVIF_DI_SETITEM-Flag im Maskenelement der LVITEM-Struktur festlegen. Dadurch wird das Betriebssystem aufgefordert, die angeforderten Listenelementinformationen zu speichern und nicht erneut nachzufragen. Für Listenansichtssteuerelemente mit der LVS_REPORT-Formatvorlage gilt dieses Flag nur für die Informationen der ersten Spalte (Unterelement 0). Das Steuerelement speichert keine Informationen für Unterelemente.

Hinweis

Der commctrl.h-Header definiert NMLVDISPINFO als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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