ITextStoreAnchor::GetTextExt 方法 (textstor.h)
ITextStoreAnchor::GetTextExt 方法以屏幕坐标形式返回文本范围的边界框。 调用方必须在文档上具有只读锁,然后才能调用此方法。
语法
HRESULT GetTextExt(
[in] TsViewCookie vcView,
[in] IAnchor *paStart,
[in] IAnchor *paEnd,
[out] RECT *prc,
[out] BOOL *pfClipped
);
参数
[in] vcView
指定上下文视图。
[in] paStart
指定定位在范围开头的定位点。
[in] paEnd
指定定位在范围末尾的定位点。
[out] prc
接收屏幕坐标中文本范围的边界框。
[out] pfClipped
接收一个布尔值,该值指定是否已剪裁边界框中的文本。 如果 为 TRUE,则边界框包含已剪裁的文本,并且不包括整个请求的文本范围。 边界框被剪裁,因为请求的范围不可见。
返回值
此方法可以返回其中一个值。
值 | 说明 |
---|---|
|
方法成功。 |
|
方法无法获取指向起始和/或结束定位点的有效接口指针。 |
|
一个或多个输入参数无效。 |
|
paStart 和 paEnd 参数指定的范围超出文档的开头或结尾。 |
|
应用程序尚未计算文本布局。 在应用程序调用 ITextStoreAnchorSink::OnLayoutChange 之前,任何其他调用都不会成功。 |
|
调用方对文档没有只读锁定。 |
注解
如果文档窗口最小化,或者指定的文本当前不可见,该方法将返回S_OK, 并将 prc 参数设置为 {0,0,0,0}。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | textstor.h |
DLL | Msctf.dll |
可再发行组件 | Windows 2000 专业版上的 TSF 1.0 |