TTTOOLINFOA 結構 (commctrl.h)

  • 發行項

TO一個 TO，FO 結構包含工具提示控件中工具的相關信息。

語法

typedef struct tagTOOLINFOA {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPSTR     lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOA, *PTOOLINFOA, *LPTTTOOLINFOA;

成員

cbSize

類型： UINT

這個 結構的大小，以位元組為單位。 必須指定這個成員。

uFlags

類型： UINT

控制工具提示顯示的旗標。 此成員可以是下列值的組合：

值 意義
TTF_ABSOLUTE
 將工具提示視窗放置在 TTM_TRACKPOSITION所提供的相同座標。 這個旗標必須與TTF_TRACK旗標搭配使用。
TTF_CENTERTIP
 將工具提示視窗置中至 uId 成員所指定的工具下方。
TTF_IDISHWND
 表示 uId 成員是工具的視窗句柄。 如果未設定此旗標， 則 uId 是工具的識別碼。
TTF_PARSELINKS

6.0 版和更新版本。 表示應該剖析工具提示文字中的連結。

請注意，Comctl32.dll 第 6 版不可轉散發，但包含在 Windows 或更新版本中。 若要使用第 6 版 Comctl32.dll，請在指令清單中指定它。 如需指令清單的詳細資訊，請參閱 啟用可視化樣式。
TTF_RTLREADING
 表示工具提示文字會以與父視窗中文字相反的方向顯示。
TTF_SUBCLASS
 表示工具提示控件應該將工具視窗子類別化，以攔截訊息，例如 WM_MOUSEMOVE。 如果未設定此旗標，您必須使用 TTM_RELAYEVENT 訊息將訊息轉送至工具提示控件。 如需工具提示控件處理之訊息的清單，請參閱TTM_RELAYEVENT。
TTF_TRACK
 將工具提示視窗放在其對應的工具旁邊，並根據 TTM_TRACKPOSITION 訊息所提供的座標移動視窗。 您必須使用 TTM_TRACKACTIVATE 訊息來啟用這種類型的工具。
TTF_TRANSPARENT
 使工具提示控制件將滑鼠事件訊息轉送至父視窗。 這僅限於工具提示視窗界限內發生的滑鼠事件。

hwnd

類型： HWND

包含工具的視窗句柄。 如果 lpszText 包含LPSTR_TEXTCALLBACK值，這個成員會識別接收 TTN_GETDISPINFO 通知碼的視窗。

uId

類型： UINT_PTR

工具的應用程式定義識別碼。 如果 uFlags 包含TTF_IDISHWND旗標， uId 必須指定工具的視窗句柄。

rect

類型： RECT

工具的周框座標。 座標相對於 hwnd 所識別視窗工作區的左上角。 如果 uFlags 包含TTF_IDISHWND旗標，則會忽略此成員。

hinst

類型： HINSTANCE

包含工具字串資源的實例句柄。 如果 lpszText 指定字串資源的識別碼，則會使用這個成員。

lpszText

類型： LPTSTR

緩衝區的指標，其中包含工具的文字，或包含文字之字串資源的標識符。 這個成員有時會用來傳回值。 如果您需要檢查傳回的值，必須指向大小足夠的有效緩衝區。 否則，它可以設定為 NULL。 如果 lpszText 設定為 LPSTR_TEXTCALLBACK，控件會將 TTN_GETDISPINFO 通知碼傳送至擁有者視窗以擷取文字。

lParam

類型： LPARAM

4.70 版和更新版本。 與工具相關聯的32位應用程式定義值。

lpReserved

類型： void*

保留的。 必須設定為 NULL。

備註

一般視窗會顯示由左至右 (LTR) 的文字。 Windows 可以 鏡像 顯示希伯來文或阿拉伯文等語言，以從右至左 (RTL) 。 一般而言，工具提示文字的顯示方向與父視窗中的文字相同。 如果已設定TTF_RTLREADING，工具提示文字會從父視窗中的文字相反方向讀取。

注意

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

規格需求

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