ITextServices：：TxQueryHitPoint 方法 (textserv.h)

项目
08/26/2023

测试指定的点是否在文本服务对象的矩形内。

语法

HRESULT TxQueryHitPoint(
  [in]  DWORD          dwDrawAspect,
        LONG           lindex,
  [in]  void           *pvAspect,
  [in]  DVTARGETDEVICE *ptd,
  [in]  HDC            hdcDraw,
  [in]  HDC            hicTargetDev,
  [in]  LPCRECT        lprcClient,
  [in]  INT            x,
  [in]  INT            y,
  [out] DWORD          *pHitResult
);

参数

[in] dwDrawAspect

类型： DWORD

绘图方面可以是以下值之一。

值	含义
DVASPECT_CONTENT	将文本内容的屏幕图像呈现到 hdcDraw 设备上下文。 hicTargetDev 和 ptd 参数提供有关目标设备上下文的信息（如果任何 (通常打印机) ）。
DVASPECT_DOCPRINT	将对象呈现到 hdcDraw 设备上下文中，就像将其打印到打印机一样。因此，文本服务对象可以优化打印机 (例如，如果) 白色，则不绘制背景色。此外，不应呈现某些特定于屏幕的元素 (，例如选择) 。 ITextServices：：TxGetNaturalSize 应从当前滚动位置开始呈现 lprcClient 矩形。

lindex

类型： LONG

不支持。

[in] pvAspect

类型： void*

有关绘图优化的信息。

[in] ptd

类型： DVTARGETDEVICE*

有关目标设备的信息。

[in] hdcDraw

类型： HDC

呈现设备上下文。

[in] hicTargetDev

类型： HDC

目标信息上下文。

[in] lprcClient

类型： LPCRECT

控件的客户端矩形，位于客户端 (设备) 完成命中测试的视图的坐标。

[in] x

类型： INT

x 坐标检查完成命中测试的视图的客户端坐标。

[in] y

类型： INT

y 坐标到检查执行命中测试的视图的客户端坐标。

[out] pHitResult

类型： DWORD*

命中测试的结果。它可以是以下任一 TXTHITRESULT 枚举值。

值	含义
TXTHITRESULT_CLOSE	点位于客户端矩形中，靠近非透明区域。
TXTHITRESULT_HIT	点位于客户端矩形中，文本上方或背景不透明。
TXTHITRESULT_NOHIT	点位于客户端矩形的外部。
TXTHITRESULT_TRANSPARENT	该点位于客户端矩形中，不在文本上方或背景是透明的。

返回值

类型： HRESULT

返回值为 HRESULT 代码。

注解

此方法允许主机对文本实现透明命中测试。

有关详细信息，请参阅 ITextServices：：TxDraw 和 ITextServices：：OnTxSetCursor 中的“备注”部分。

要求


最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	textserv.h
DLL	Msftedit.dll