ITfRange：：CompareStart 方法 (msctf.h)

ITfRange：：CompareStart方法會將此文字範圍的開始錨點位置與另一個範圍內的錨點進行比較。

語法

HRESULT CompareStart(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pWith,
  [in]  TfAnchor     aPos,
  [out] LONG         *plResult
);

[in] ec

[in] pWith

指定範圍的指標，其中錨點要與這個範圍開始錨點進行比較。

[in] aPos

列舉專案，指出要與這個範圍開始錨點比較之指定 pWith 範圍的錨點。

值	意義
TF_ANCHOR_START	比較此範圍開始錨點與指定的範圍開始錨點。
TF_ANCHOR_END	比較此範圍開始錨點與指定的範圍結束錨點。

[out] plResult

這個範圍開始錨點與指定 pWith 範圍錨點之間的比較結果指標。

值	意義
-1	這個開始錨點位於指定範圍的錨點後方 (< 指定之範圍錨點的位置) 。
0	這個開始錨點與指定範圍的錨點位於相同的位置。
+1	這個開始錨點位於指定範圍的錨點之前， (> 指定之範圍錨點位置的錨點位置) 。

這個方法可以傳回其中一個值。

值	描述
S_OK	此方法成功。
E_FAIL	發生未指定的錯誤。
E_INVALIDARG	一或多個參數無效。
TF_E_NOLOCK	ec參數的值是不正確 Cookie，或者呼叫端沒有唯讀鎖定。

除非兩個錨點位於單一區域中，否則這個方法永遠不會傳回 0。如果呼叫端只需要有關兩個錨點是否位於相同位置的資訊，則 ITfRange：：IsEqualStart 更有效率。


最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	msctf.h
Dll	Msctf.dll
可轉散發套件	Windows 2000 專業版上的 TSF 1.0