ITextStoreACP2：：GetTextExt 方法 (textstor.h)

  • 项目

获取位于指定字符位置的文本的边界框（以屏幕坐标表示）。 调用此方法之前，调用方必须在文档上具有只读锁。

语法

HRESULT GetTextExt(
  [in]  TsViewCookie vcView,
  [in]  LONG         acpStart,
  [in]  LONG         acpEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

参数

[in] vcView

指定上下文视图。

[in] acpStart

指定要在文档中获取的文本的起始字符位置。

[in] acpEnd

指定要在文档中获取的文本的结束字符位置。

[out] prc

接收位于指定字符位置的文本屏幕坐标中的边界框。

[out] pfClipped

接收一个布尔值，该值指定是否剪裁了边界框中的文本。 如果此参数为 TRUE，则边界框包含剪切的文本，并且不包括整个请求的文本范围。 边界框被剪裁，因为请求的范围不可见。

返回值

此方法可以返回其中一个值。

值 说明
S_OK
 方法成功。
TS_E_INVALIDARG
 指定的起始字符和结束字符位置相等。
TS_E_INVALIDPOS
 acpStart 和 acpEnd 参数指定的范围超出文档的开头或结尾。
TS_E_NOLAYOUT
 应用程序尚未计算文本布局。
TS_E_NOLOCK
 调用方对文档没有只读锁。

注解

如果最小化文档窗口，或者指定的文本当前不可见，该方法将返回 S_OK ，并将 prc 参数设置为 {0,0,0,0}。

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 textstor.h
DLL Msctf.dll

另请参阅

ITextStoreACP2