NMTTDISPINFOW-Struktur (commctrl.h)

  • Artikel

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

Syntax

typedef struct tagNMTTDISPINFOW {
  NMHDR     hdr;
  LPWSTR    lpszText;
  WCHAR     szText[80];
  HINSTANCE hinst;
  UINT      uFlags;
  LPARAM    lParam;
} NMTTDISPINFOW, *LPNMTTDISPINFOW;

Member

hdr

Typ: NMHDR

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

lpszText

Typ: LPTSTR

Zeiger auf eine NULL-Zeichenfolge, die als QuickInfotext angezeigt wird. Wenn hinst ein instance-Handle 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. QuickInfotext, der mehr als 80 TCHARs überschreitet, finden Sie in den Kommentaren im Abschnitt "Hinweise" dieses Dokuments.

hinst

Typ: HINSTANCE

Behandeln Sie den 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 angibt, wie das element idFrom der eingeschlossenen NMHDR-Struktur interpretiert werden soll.

Wert Bedeutung
TTF_IDISHWND
 Wenn dieses Flag festgelegt ist, ist idFrom das Handle des Tools. Andernfalls ist es der 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 die gleiche Richtung gelesen wie der Text im übergeordneten Fenster. Damit eine QuickInfo in umgekehrter Richtung aus dem übergeordneten Fenster gelesen wird, fügen Sie dem uFlags-Element beim Verarbeiten der Benachrichtigung das flag TTF_RTLREADING hinzu.
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 die Länge von 80 TCHARs überschreitet. Das System entfernt automatisch die ampersand-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 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