共用方式為


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 終止字串的指標。 如果 指定實例句柄,這個成員必須是字元串資源的標識符。

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 樣式,否則系統&會自動從傳遞至工具提示控件的所有字串 TCHARTCHAR 等量。

注意

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

要求

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