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
Library	UxTheme.lib
DLL	UxTheme.dll

另请参阅

属性标识符