NMTTDISPINFOW 結構 (commctrl.h)

包含用來處理 TTN_GETDISPINFO 通知程式代碼的資訊。 這個結構會取代 TOOLTIPTEXT 結構。

語法

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

成員

hdr

類型： NMHDR

NMHDR 結構，其中包含通知的其他資訊。

lpszText

類型： LPTSTR

Null 終止字串的指標，該字串會顯示為工具提示文字。 如果 hinst 指定實例句柄，這個成員必須是字串資源的標識碼。

szText[80]

類型： TCHAR

接收工具提示文字的緩衝區。 應用程式可以將文字複製到這個緩衝區，而不是指定字串位址或字串資源。 如需超過 80 TCHAR的工具提示文字，請參閱本檔的一節中的批注。

hinst

類型： HINSTANCE

實例的句柄，其中包含要當做工具提示文字使用的字串資源。 如果 lpszText 是工具提示文字字串的地址，這個成員必須是 NULL。

uFlags

類型： UINT

旗標，指出如何解譯內含NMHDR結構的idFrom成員。

值	意義
TTF_IDISHWND	如果設定此旗標， idFrom 是工具的句柄。 否則，它是工具的標識碼。
TTF_RTLREADING	Windows 可以 鏡像 顯示希伯來文或阿拉伯文等語言，以從右至左 (RTL) 。 一般而言，工具提示文字的讀取方向與父視窗中的文字相同。 若要讓工具提示從其父視窗相反的方向讀取，請在處理通知時，將TTF_RTLREADING旗標新增至 uFlags 成員。
TTF_DI_SETITEM	4.70 版。 如果您在處理通知時將此旗標新增至 uFlags ，工具提示控件會保留提供的資訊，而不會再次要求。

lParam

類型： LPARAM

4.70 版。 與工具相關聯的應用程式定義數據。

備註

當工具提示中使用的文字長度超過 80 TCHAR時，您必須將 lpszText 陣列指向您自己的私人緩衝區。 除非控件具有TTS_NOPREFIX樣式，否則系統會自動從傳遞至工具提示控件的所有字串移除連字元 (& ) 快捷鍵 TCHAR。

注意

commctrl.h 標頭會將 NMTTDISPINFO 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	commctrl.h