ITfRange：：ShiftStart 方法 (msctf.h)

發行項
08/24/2023

移動範圍的開始錨點。

語法

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

參數

[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