NMTTDISPINFOA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen, die bei der Behandlung des TTN_GETDISPINFO Benachrichtigungscodes verwendet werden. Diese Struktur ersetzt die TOOLTIPTEXT-Struktur .

Syntax

typedef struct tagNMTTDISPINFOA {
  NMHDR     hdr;
  LPSTR     lpszText;
  char      szText[80];
  HINSTANCE hinst;
  UINT      uFlags;
  LPARAM    lParam;
} NMTTDISPINFOA, *LPNMTTDISPINFOA;

Member

hdr

Typ: NMHDR

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

lpszText

Typ: LPTSTR

Zeiger auf eine NULL-endende Zeichenfolge, die als QuickInfotext angezeigt wird. Wenn hinst ein instance Handle angibt, muss dieser Member der Bezeichner einer Zeichenfolgenressource sein.

szText[80]

Typ: TCHAR

Puffer, der den QuickInfo-Text empfängt. Eine Anwendung kann den Text in diesen Puffer kopieren, anstatt eine Zeichenfolgenadresse oder Zeichenfolgenressource anzugeben. QuickInfo-Text, der 80 TCHAR-Werte überschreitet, finden Sie in den Kommentaren im Abschnitt "Hinweise" dieses Dokuments.

hinst

Typ: HINSTANCE

Handle mit dem instance, der eine Zeichenfolgenressource enthält, die als QuickInfotext verwendet werden soll. Wenn lpszText die Adresse der QuickInfo-Textzeichenfolge ist, muss dieser Member NULL sein.

uFlags

Typ: UINT

Flags, die angeben, wie der idFrom-Member der enthaltenen NMHDR-Struktur interpretiert wird.

Wert Bedeutung
TTF_IDISHWND
 Wenn dieses Flag festgelegt ist, ist idFrom das Handle des Tools. Andernfalls ist dies der Bezeichner des Tools.
TTF_RTLREADING
 Fenster können in Anzeigesprachen wie Hebräisch oder Arabisch gespiegelt werden, die von rechts nach links (RTL) gelesen werden. Normalerweise wird QuickInfo-Text in derselben Richtung gelesen wie der Text im übergeordneten Fenster. Wenn eine QuickInfo in entgegengesetzter Richtung aus dem übergeordneten Fenster gelesen werden soll, fügen Sie das flag TTF_RTLREADING dem uFlags-Element hinzu, wenn die Benachrichtigung verarbeitet wird.
TTF_DI_SETITEM

Version 4.70. Wenn Sie dieses Flag während der Verarbeitung der Benachrichtigung zu uFlags hinzufügen, behält das QuickInfo-Steuerelement die angegebenen Informationen bei und fordert sie nicht erneut an.

lParam

Typ: LPARAM

Version 4.70. Anwendungsdefinierte Daten, die dem Tool zugeordnet sind.

Hinweise

Sie müssen das lpszText-Array auf Ihren eigenen privaten Puffer verweisen, wenn der in der QuickInfo verwendete Text eine Länge von 80 TCHARs überschreitet. Das System entfernt automatisch die &-Beschleuniger-TCHAR-S aus allen Zeichenfolgen, die an ein QuickInfo-Steuerelement übergeben werden, es sei denn, das Steuerelement verfügt über die TTS_NOPREFIX Formatvorlage.

Hinweis

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