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

另請參閱

屬性識別項