NMTBDISPINFOA-Struktur (commctrl.h)

Enthält und empfängt Anzeigeinformationen für ein Symbolleistenelement. Diese Struktur wird mit dem TBN_GETDISPINFO Benachrichtigungscode verwendet.

Syntax

typedef struct {
  NMHDR     hdr;
  DWORD     dwMask;
  int       idCommand;
  DWORD_PTR lParam;
  int       iImage;
  LPSTR     pszText;
  int       cchText;
} NMTBDISPINFOA, *LPNMTBDISPINFOA;

Angehörige

hdr

Typ: NMHDR-

NMHDR Struktur, die zusätzliche Informationen zur Benachrichtigung enthält.

dwMask

Typ: DWORD-

Satz von Flags, die angeben, welche Elemente dieser Struktur angefordert werden. Dabei kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert	Bedeutung
TBNF_IMAGE	Der Bildindex des Elements wird angefordert. Der Bildindex muss im iImage Member platziert werden.
TBNF_TEXT	Derzeit nicht implementiert.
TBNF_DI_SETITEM	Legen Sie dieses Kennzeichen beim Verarbeiten von TBN_GETDISPINFOfest; Das Symbolleistensteuerelement behält die bereitgestellten Informationen bei und fordert sie nicht erneut an.

idCommand

Typ: int

Befehlsbezeichner des Elements, für das Anzeigeinformationen angefordert werden. Dieses Element wird vom Steuerelement ausgefüllt, bevor er den Benachrichtigungscode sendet.

lParam

Typ: DWORD_PTR

Anwendungsdefinierter Wert, der dem Element zugeordnet ist, für das Anzeigeinformationen angefordert werden. Dieses Element wird vom Steuerelement ausgefüllt, bevor der Benachrichtigungscode gesendet wird.

iImage

Typ: int

Bildindex für das Element.

pszText

Typ: LPTSTR-

Zeigen Sie auf einen Zeichenpuffer, der den Text des Elements empfängt.

cchText

Typ: int

Größe des pszText- Puffers in Zeichen.

Bemerkungen

Anmerkung

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