ITextRange::Metode InRange (tom.h)

Menentukan apakah rentang ini berada di dalam atau pada teks yang sama dengan rentang tertentu.

Sintaksis

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

Parameter

pRange

Jenis: ITextRange

Teks yang dibandingkan dengan rentang saat ini.

pValue

Jenis: panjang*

Hasil perbandingan. Penunjuk bisa null. Metode mengembalikan pB tomTrue hanya jika rentang berada di atau pada teks yang sama dengan pRange.

Mengembalikan nilai

Jenis: HRESULT

Metode mengembalikan nilai HRESULT . Jika metode berhasil, metode akan mengembalikan S_OK. Jika metode gagal, metode akan mengembalikan S_FALSE.

Komentar

Agar rentang2 terkandung dalam rentang1, kedua rentang harus dalam cerita yang sama, dan batas rentang2 harus memenuhi salah satu pernyataan berikut.

• Posisi karakter awal dan akhir rentang1 sama dengan rentang2. Artinya, kedua rentang mengalami degenerasi dan memiliki titik penyisipan yang identik.
• Range2 adalah rentang nondegenerasi dengan posisi karakter awal dan akhir pada atau dalam rentang1.

    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

Ketika ITextRange::FindText, ITextRange::MoveWhile, dan ITextRange::MoveUntil metode keluarga digunakan, Anda dapat menggunakan satu rentang untuk berjalan di rentang lain dengan menentukan jumlah batas karakter yang sesuai (misalnya, lihat Keterangan di ITextRange::Temukan).

ITextRange::IsEqual adalah kasus khusus ITextRange::InRange yang mengembalikan pBtomTrue jika pRange memiliki posisi karakter awal dan akhir yang sama dan termasuk dalam cerita yang sama.

Persyaratan

Lihat juga

Konseptual

FindText

ITextRange

MoveUntil

MoveWhile

Referensi

Model Objek Teks