共用方式為

TTTOOLINFOA 結構 （commctrl.h）

  • 發行項

TOOLINFO 結構包含工具提示控件中工具的相關信息。

語法

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