ITfRange：：ShiftStart 方法 (msctf.h)

项目
08/24/2023

移动范围的开始定位点。

语法

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。

返回值

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

值	说明
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