Freigeben über

NMLVDISPINFOA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen zu einem LVN_GETDISPINFO oder LVN_SETDISPINFO Benachrichtigungscode. Diese Struktur ist identisch mit der LV_DISPINFO-Struktur, wurde jedoch in Standardbenennungskonventionen umbenannt.

Syntax

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

Angehörige

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 zum Element. Das Mask Member enthält eine Reihe von Bitkennzeichnungen, die angeben, welche Elementattribute relevant sind. Weitere Informationen zu den verfügbaren Bitkennzeichnungen finden Sie unter LVITEM-.

Bemerkungen

Wenn die LVITEM- Struktur Elementtext empfängt, geben die pszText und cchTextMax Member die Adresse und Größe eines Puffers an. Sie können entweder Text in den Puffer kopieren oder die Adresse einer Zeichenfolge dem pszText Member zuweisen. Im letzteren Fall dürfen Sie die Zeichenfolge erst ändern oder löschen, wenn der entsprechende Elementtext gelöscht wird, 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 Mask Element der LVITEM- Struktur festlegen. Dadurch wird dem Betriebssystem mitgeteilt, die angeforderten Listenelementinformationen zu speichern und nicht erneut zu fragen. Bei Listenansichtssteuerelementen mit der LVS_REPORT Formatvorlage gilt dieses Kennzeichen nur für die Informationen der ersten Spalte (Unterelement 0). Das Steuerelement speichert keine Informationen für Unterelemente.

Anmerkung

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