ITfRange::ShiftStart 方法 (msctf.h)
移动范围的开始定位点。
语法
HRESULT ShiftStart(
[in] TfEditCookie ec,
[in] LONG cchReq,
[out] LONG *pcch,
[in] const TF_HALTCOND *pHalt
);
parameters
[in] ec
包含标识编辑上下文的编辑 Cookie。 这是从 ITfDocumentMgr::CreateContext 或 ITfEditSession::D oEditSession 获取的。
[in] cchReq
包含开始定位点移动的字符数。 负值会导致定位点向后移动,正值会导致定位点向前移动。
[out] pcch
指向 LONG 值的指针,该值接收定位点移动的字符数。
[in] pHalt
指向包含移位条件 的TF_HALTCOND 结构的指针。 此参数是可选的,可以为 NULL。
返回值
此方法可以返回其中一个值。
值 | 说明 |
---|---|
|
方法成功。 |
|
一个或多个参数无效。 |
|
发生了未指定的错误。 |
|
ec 标识的编辑上下文没有只读锁。 |
注解
范围的开始和结束位置称为定位点。
此方法无法将定位点移出区域边界。 如果移位达到区域边界,则实际移动的字符数将小于请求的字符数。 ITfRange::ShiftStartRegion 用于将定位点移动到相邻区域。
如果移位操作导致范围开始定位点移过结束定位点,则结束定位点将移动到与起始定位点相同的位置。
ITfRange::ShiftStart 可能是一个冗长的操作。 为了提高性能,请尽可能使用 ITfRange::ShiftStartToRange 。
要求
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | msctf.h |
DLL | Msctf.dll |
可再发行组件 | Windows 2000 专业版上的 TSF 1.0 |