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,则边界框包含已剪裁的文本,并且不包括整个请求的文本范围。 由于请求的范围不可见,边界框被剪裁。
返回值
此方法可以返回其中一个值。
值 | 说明 |
---|---|
|
方法成功。 |
|
指定的开始字符和结束字符位置相等。 |
|
acpStart 和 acpEnd 参数指定的范围超出文档的末尾或文档顶部。 |
|
应用程序尚未计算文本布局。 |
|
调用方对文档没有只读锁定。 |
注解
如果文档窗口最小化,或者指定的文本当前不可见,该方法将返回S_OK, 并将 prc 参数设置为 {0,0,0,0}。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | msctf.h |
DLL | Msimtf.dll |
可再发行组件 | Windows 2000 专业版上的 TSF 1.0 |