Share via

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

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

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー tom.h
[DLL] Msftedit.dll

関連項目

概念

Findtext

ITextRange

MoveUntil

MoveWhile

リファレンス

Text オブジェクト モデル