ITextServices::TxQueryHitPoint 方法 (textserv.h)

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

语法

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 设备上下文。

hicTargetDevptd 参数提供有关目标设备上下文的信息(如果任何 (通常打印机) )。

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::TxDrawITextServices::OnTxSetCursor 中的“备注”部分。

要求

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

请参阅

概念性

ITextServices

OnTxSetCursor

引用

TxDraw

无窗口 Rich Edit 控件