共用方式為


ITfRange::ShiftStart 方法 (msctf.h)

移動範圍的開始錨點。

語法

HRESULT ShiftStart(
  [in]  TfEditCookie      ec,
  [in]  LONG              cchReq,
  [out] LONG              *pcch,
  [in]  const TF_HALTCOND *pHalt
);

參數

[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