次の方法で共有


ITextRange::InRange メソッド (tom.h)

この範囲が指定した範囲内にあるか、指定した範囲と同じテキストにあるかを判断します。

構文

HRESULT InRange(
  ITextRange *pRange,
  long       *pValue
);

パラメーター

pRange

型: ITextRange*

現在の範囲と比較されるテキスト。

pValue

型: long*

比較結果。 ポインターには null を指定できます。 このメソッドは、範囲が pRangeと同じテキストにある場合にのみ、pB が tomTrue

戻り値

型: HRESULT

このメソッドは、HRESULT 値を返します。 メソッドが成功した場合は、S_OKを返します。 メソッドが失敗した場合は、S_FALSEを返します。

備考

range2 を range1 に含めるには、両方の範囲が同じストーリーに含まれている必要があり、range2 の制限は次のいずれかのステートメントを満たす必要があります。

  • range1 の開始位置と終了文字位置は range2 と同じです。 つまり、両方の範囲が縮退し、同じ挿入ポイントを持ちます。
  • Range2 は、開始文字と終了文字が range1 の位置または範囲内の非生成範囲です。
次の例は、ある範囲を別の範囲で歩く方法を示しています。
    range2 = range1.Duplicate
    range2.End = range2.Start       ' Collapse range2 to its start position 
    While range2.InRange(range1)    ' Iterate so long as range2 remains within range1
         ...   ' This code would change the range2 character positions 
    Wend

ITextRange::FindTextITextRange::MoveWhile、および ITextRange::MoveUntil メソッド ファミリを使用する場合は、適切な文字数制限数を指定することで、1 つの範囲を使用して別の範囲をウォークできます (たとえば、「ITextRange::Findの備考」を参照)。

ITextRange::IsEqual は、pRange の開始位置と終了文字の位置が同じで、同じストーリーに属している場合 pBtomTrue を返す、ITextRange::InRange の特殊なケースです。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー tom.h
DLL Msftedit.dll

関連項目

概念

FindText の

ITextRange を する

MoveUntil

MoveWhile

リファレンス

テキスト オブジェクト モデルの