NMTBDISPINFOA-Struktur (commctrl.h)

  • Artikel

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;

Member

hdr

Typ: NMHDR

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

dwMask

Typ: DWORD

Eine Reihe von Flags, die angeben, welche Elemente dieser Struktur angefordert werden. Dies kann mindestens einer der folgenden Werte sein.

Wert Bedeutung
TBNF_IMAGE
 Der Bildindex des Elements wird angefordert. Der Bildindex muss im iImage-Element platziert werden.
TBNF_TEXT
 Derzeit nicht implementiert.
TBNF_DI_SETITEM
 Legen Sie dieses Flag fest, wenn Sie TBN_GETDISPINFO verarbeiten. Das Symbolleistensteuerelement behält die angegebenen 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 es 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

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

cchText

Typ: int

Größe des pszText-Puffers in Zeichen.

Hinweise

Hinweis

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

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