Freigeben über

NMTTDISPINFOA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen zur Behandlung des TTN_GETDISPINFO Benachrichtigungscodes. 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;

Angehörige

hdr

Typ: NMHDR-

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

lpszText

Typ: LPTSTR-

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die als QuickInfo-Text angezeigt wird. Wenn hinweisst ein Instanzhandle angibt, muss dieses Element 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. Informationen zu QuickInfo-Text, der 80 TCHARsüberschreitet, finden Sie in den Kommentaren im Abschnitt "Anmerkungen" dieses Dokuments.

hinst

Typ: HINSTANCE-

Behandeln Sie die Instanz, die eine Zeichenfolgenressource enthält, die als QuickInfo-Text verwendet werden soll. Wenn lpszText- die Adresse der QuickInfo-Textzeichenfolge ist, muss dieses Element NULL-sein.

uFlags

Typ: UINT-

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

Wert Bedeutung
TTF_IDISHWND
 Wenn dieses Kennzeichen festgelegt ist, ist idFrom das Handle des Tools. Andernfalls handelt es sich um den Bezeichner des Tools.
TTF_RTLREADING
 Windows kann gespiegelt werden, um Sprachen wie Hebräisch oder Arabisch anzuzeigen, die von rechts nach links (RTL) gelesen werden. Normalerweise wird QuickInfo-Text in der gleichen Richtung wie der Text im übergeordneten Fenster gelesen. Wenn eine QuickInfo in entgegengesetzter Richtung aus dem übergeordneten Fenster gelesen werden soll, fügen Sie beim Verarbeiten der Benachrichtigung das TTF_RTLREADING Flag zum uFlags-Element Mitglieds hinzu.
TTF_DI_SETITEM

Version 4.70. Wenn Sie dieses Kennzeichen uFlags beim Verarbeiten der Benachrichtigung hinzufügen, behält das QuickInfo-Steuerelement die bereitgestellten Informationen bei und fordert sie nicht erneut an.

lParam

Typ: LPARAM-

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

Bemerkungen

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

Anmerkung

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