ITextRange::Metode InRange (tom.h)

Artikel
03/03/2024

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

Sintaks

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 adalah tomTrue hanya jika rentang berada di atau pada teks yang sama dengan pRange.

Nilai kembali

Jenis: HRESULT

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

Keterangan

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

Posisi karakter awal dan akhir dari range1 sama dengan range2. Artinya, kedua rentang berdegenerasi dan memiliki titik penyisipan yang identik.
Range2 adalah rentang nondegenerasi dengan posisi karakter awal dan akhir pada atau dalam rentang1.

Contoh berikut menunjukkan cara berjalan satu rentang dengan rentang lain.

    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 keluarga metode ITextRange::FindText, ITextRange::MoveWhile, dan ITextRange::MoveUntil digunakan, Anda dapat menggunakan satu rentang untuk berjalan ke rentang lain dengan menentukan jumlah batas karakter yang sesuai (misalnya, lihat Keterangan di ITextRange::Find).

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

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	tom.h
DLL	Msftedit.dll