NMLVGETINFOTIPW-Struktur (commctrl.h)

Enthält und empfängt Listenansichtselementinformationen, die zum Anzeigen einer QuickInfo für ein Element erforderlich sind. Diese Struktur wird mit dem LVN_GETINFOTIP Benachrichtigungscode verwendet.

Syntax

typedef struct tagNMLVGETINFOTIPW {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPWSTR pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIPW, *LPNMLVGETINFOTIPW;

Member

hdr

Typ: NMHDR

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

dwFlags

Typ: DWORD

Entweder null oder LVGIT_UNFOLDED. Siehe Hinweise.

pszText

Typ: LPTSTR

Adresse eines Zeichenfolgenpuffers, der zusätzliche Textinformationen empfängt. Wenn dwFlags null ist, enthält dieses Element den vorhandenen Elementtext. In diesem Fall sollten Sie zusätzlichen Text an das Ende dieser Zeichenfolge anfügen. Die Größe dieses Puffers wird durch die cchTextMax-Struktur angegeben.

cchTextMax

Typ: int

Größe des Puffers in Zeichen, auf den von pszText verwiesen wird. Obwohl Sie niemals davon ausgehen sollten, dass dieser Puffer eine bestimmte Größe hat, kann der INFOTIPSIZE-Wert für Entwurfszwecke verwendet werden.

iItem

Typ: int

Nullbasierter Index des Elements, auf das sich diese Struktur bezieht.

iSubItem

Typ: int

Ein basierter Index des Unterelements, auf das sich diese Struktur bezieht. Wenn dieses Element 0 ist, verweist die Struktur auf das Element und nicht auf ein Unterelement. Dieser Member wird derzeit nicht verwendet und ist immer 0.

lParam

Typ: LPARAM

Anwendungsdefinierter Wert, der dem Element zugeordnet ist. Dieser Member wird derzeit nicht verwendet und ist immer 0.

Hinweise

Ein Element wird als gefaltet bezeichnet, wenn der aktuell angezeigte Text abgeschnitten wird. Wenn LVGIT_UNFOLDED in dwFlags zurückgegeben wird, wird der vollständige Text des Elements bereits angezeigt, sodass es nicht in der QuickInfo angezeigt werden muss.

Hinweis

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