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 |