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
控制工具提示顯示的旗標。 此成員可以是下列值的組合:
值 | 意義 |
---|---|
|
將工具提示視窗放置在 TTM_TRACKPOSITION所提供的相同座標。 這個旗標必須與TTF_TRACK旗標搭配使用。 |
|
將工具提示視窗置中至 uId 成員所指定的工具下方。 |
|
表示 uId 成員是工具的視窗句柄。 如果未設定此旗標, 則 uId 是工具的識別碼。 |
|
6.0 版和更新版本。 表示應該剖析工具提示文字中的連結。 請注意,Comctl32.dll 第 6 版不可轉散發,但包含在 Windows 或更新版本中。 若要使用第 6 版 Comctl32.dll,請在指令清單中指定它。 如需指令清單的詳細資訊,請參閱 啟用可視化樣式。 |
|
表示工具提示文字會以與父視窗中文字相反的方向顯示。 |
|
表示工具提示控件應該將工具視窗子類別化,以攔截訊息,例如 WM_MOUSEMOVE。 如果未設定此旗標,您必須使用 TTM_RELAYEVENT 訊息將訊息轉送至工具提示控件。 如需工具提示控件處理之訊息的清單,請參閱TTM_RELAYEVENT。 |
|
將工具提示視窗放在其對應的工具旁邊,並根據 TTM_TRACKPOSITION 訊息所提供的座標移動視窗。 您必須使用 TTM_TRACKACTIVATE 訊息來啟用這種類型的工具。 |
|
使工具提示控制件將滑鼠事件訊息轉送至父視窗。 這僅限於工具提示視窗界限內發生的滑鼠事件。 |
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 |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應