NMLVGETINFOTIPA-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 tagNMLVGETINFOTIPA {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPSTR  pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIPA, *LPNMLVGETINFOTIPA;

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 dieser Member den vorhandenen Elementtext. In diesem Fall sollten Sie jeden zusätzlichen Text am Ende dieser Zeichenfolge anfügen. Die Größe dieses Puffers wird durch die cchTextMax-Struktur angegeben.

cchTextMax

Typ: int

Größe des Puffers, auf den pszText verweist, in Zeichen. Obwohl Sie niemals davon ausgehen sollten, dass dieser Puffer eine bestimmte Größe aufweist, 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 dieser Member null ist, verweist die Struktur auf das Element und nicht auf ein Unterelement. Dieser Member wird derzeit nicht verwendet und ist immer null.

lParam

Typ: LPARAM

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

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

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	commctrl.h