NMTTDISPINFOA 結構 (commctrl.h)

  • 發行項

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

語法

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

成員

hdr

類型： NMHDR

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

lpszText

類型： LPTSTR

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

szText[80]

類型： TCHAR

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

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 陣列指向您自己的私人緩衝區。 系統會自動從傳遞至工具提示控件的所有字串中移除 ampersand (&) 快捷鍵 TCHAR， 除非控件具有 TTS_NOPREFIX 樣式。

注意

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

規格需求

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