NMLVGETINFOTIPA-Struktur (commctrl.h)

Enthält Informationen zu Listenansichtselementen, 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;

Angehörige

hdr

Typ: NMHDR-

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

dwFlags

Typ: DWORD-

Entweder Null oder LVGIT_UNFOLDED. Siehe Anmerkungen.

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 am Ende dieser Zeichenfolge zusätzlichen Text anfügen. Die Größe dieses Puffers wird durch die cchTextMax- Struktur angegeben.

cchTextMax

Typ: int

Größe des Puffers in Zeichen, auf den pszTextverweist. 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 1-basierter Index des Unterelements, auf das sich diese Struktur bezieht. Wenn dieses Element null ist, verweist die Struktur auf das Element und nicht auf ein Unterelement. Dieses Element wird derzeit nicht verwendet und ist immer null.

lParam

Typ: LPARAM-

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

Bemerkungen

Ein Element soll gefaltet werden, 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 in der QuickInfo nicht angezeigt werden muss.

Anmerkung

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

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	commctrl.h