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	1 つ以上のパラメーターが無効です。
TF_E_NOLOCK	ec パラメーターの値が無効な Cookie であるか、呼び出し元に読み取り専用ロックがありません。

2 つのアンカーが 1 つのリージョンに存在しない限り、このメソッドは 0 を返しません。呼び出し元で 2 つのアンカーが同じ場所に配置されているかどうかについての情報のみが必要な場合は、 ITfRange::IsEqualStart の方が効率的です。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	msctf.h
[DLL]	Msctf.dll
再頒布可能パッケージ	Windows 2000 Professional の TSF 1.0