iTfRange::ShiftStartRegion 方法 (msctf.h)

将起始定位点移动到相邻区域。

语法

HRESULT ShiftStartRegion(
  [in]  TfEditCookie ec,
  [in]  TfShiftDir   dir,
  [out] BOOL         *pfNoRegion
);

parameters

[in] ec

包含标识从 ITfDocumentMgr::CreateContextITfEditSession::D oEditSession 获取的编辑上下文的编辑 Cookie。

[in] dir

包含一个 TfShiftDir 值,该值指定要将起始定位点移动到哪个相邻区域。

[out] pfNoRegion

指向 BOOL 的指针,该 BOOL 接收一个标志,该标志指示定位点是否位于另一个区域旁边。 如果定位点不与另一个区域相邻,则接收非零值,否则接收零值。

返回值

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

说明
S_OK
方法成功。
E_INVALIDARG
pfNoRegion 无效。
TF_E_NOLOCK
ec 标识的编辑上下文没有只读锁。

注解

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

在调用此方法之前,定位点必须与所需区域相邻。 如果不是,则 pfNoRegion 接收非零值,并且不会移动定位点。 如果定位点与所需区域相邻, 则 pfNoRegion 接收零,并将定位点移动到该区域。

要求

   
最低受支持的客户端 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::ShiftEndRegion

ITfRange::ShiftStart

TfShiftDir