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::CreateContextITfEditSession::D oEditSession 获取的。

[in] cchReq

包含开始定位点移动的字符数。 负值会导致定位点向后移动,正值会导致定位点向前移动。

[out] pcch

指向 LONG 值的指针,该值接收定位点移动的字符数。

[in] pHalt

指向包含移位条件 的TF_HALTCOND 结构的指针。 此参数是可选的,可以为 NULL

返回值

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

说明
S_OK
方法成功。
E_INVALIDARG
一个或多个参数无效。
E_FAIL
发生了未指定的错误。
TF_E_NOLOCK
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

另请参阅

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::ShiftEnd

ITfRange::ShiftStartRegion

ITfRange::ShiftStartToRange

TF_HALTCOND