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 会更高效。