iTfRange：：ShiftStartToRange 方法 (msctf.h)

将此范围的起始定位点移动到另一个范围内的定位点。

语法

HRESULT ShiftStartToRange(
  [in] TfEditCookie ec,
  [in] ITfRange     *pRange,
  [in] TfAnchor     aPos
);

参数

[in] ec

包含标识从 ITfDocumentMgr：：CreateContext 或 ITfEditSession：:D oEditSession 获取的编辑上下文的编辑 Cookie。

[in] pRange

指向 ITfRange 接口的指针，该接口包含起始定位点要移动到的定位点。

[in] aPos

包含一个 TfAnchor 值，该值指定要将开始定位点移动到 pRange 的哪个定位点。

返回值

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

值	说明
S_OK	方法成功。
E_INVALIDARG	pRange 无效。
E_FAIL	发生了未指定的错误。
TF_E_NOLOCK	ec 标识的编辑上下文没有只读锁。

注解

范围的开始和结束位置称为定位点。

如果移位操作导致范围开始定位点移过结束定位点，则结束定位点将移动到与起始定位点相同的位置。

此方法比 ITfRange：：ShiftStart 更有效，应尽可能使用此方法。

要求

要求	值
最低受支持的客户端	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：：ShiftEndToRange

ITfRange：：ShiftStart

TfAnchor