HitTestThemeBackground 函式 (uxtheme.h)
擷取視覺樣式所指定背景中某個點的點擊測試程序代碼。
語法
HRESULT HitTestThemeBackground(
[in] HTHEME hTheme,
[in] HDC hdc,
[in] int iPartId,
[in] int iStateId,
[in] DWORD dwOptions,
[in] LPCRECT pRect,
[in] HRGN hrgn,
[in] POINT ptTest,
[out] WORD *pwHitTestCode
);
參數
[in] hTheme
類型： HTHEME
處理視窗的指定主題數據。 使用 OpenThemeData 建立 HTHEME。
[in] hdc
類型： HDC
繪製時要使用的 HDC。 此參數可以設定為 NULL。
[in] iPartId
類型： int
指定元件之 int 類型的值。 請參閱 元件和狀態。
[in] iStateId
類型： int
int 類型的值，指定元件的狀態。 請參閱 元件和狀態。
[in] dwOptions
類型： DWORD
指定點擊測試選項的 DWORD。 如需選項清單，請參閱 點擊測試選項 。
[in] pRect
類型： LPCRECT
包含邏輯座標中系結背景之矩形之 RECT 結構的指標。
[in] hrgn
類型： HRGN
可用來指定點擊測試區域界限的區域句柄。 此參數可以設定為 NULL。
[in] ptTest
類型： POINT
包含 點座標的 POINT 結構。
[out] pwHitTestCode
類型： WORD*
WORD ，接收點擊測試程序代碼，指出 ptTest 中的點是否位於 pRect 或 hrgn 所系結的背景區域中。 如需傳回的值清單，請參閱 點擊測試傳回值 。
傳回值
類型： HRESULT
如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
ptTest 和 pRect 中的值應該位於相同的座標系統中，例如客戶端或螢幕。 如果使用 hrgn 參數，則必須在 與 pRect 和 ptTest 相同的座標中指定它。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | uxtheme.h |
| 程式庫 | UxTheme.lib |
| Dll | UxTheme.dll |