ITfContextOwner：：GetTextExt 方法 (msctf.h)

ITfContextOwner：：GetTextExt 方法返回位于指定字符位置的文本的边框（以屏幕坐标表示）。调用方必须在文档上具有只读锁，然后才能调用此方法。

语法

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

[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 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	msctf.h
DLL	Msimtf.dll
可再发行组件	Windows 2000 专业版上的 TSF 1.0