ITextRange::Metode MoveUntil (tom.h)

Artikel
03/03/2024

Mencari hingga Menghitung karakter untuk karakter pertama dalam kumpulan karakter yang ditentukan oleh Cset. Jika karakter ditemukan, rentang akan diciutkan ke titik tersebut. Awal pencarian dan arah juga ditentukan oleh Count.

Sintaks

HRESULT MoveUntil(
  VARIANT *Cset,
  long    Count,
  long    *pDelta
);

Parameter

Cset

Jenis: VARIAN*

Set karakter yang digunakan dalam kecocokan. Ini bisa menjadi string karakter eksplisit atau indeks set karakter. Untuk informasi selengkapnya, lihat Set Kecocokan Karakter.

Count

Jenis: panjang

Jumlah maksimum karakter yang akan dilewati. Nilai defaultnya adalah tomForward, yang mencari di akhir cerita. Jika Count kurang dari nol, pencarian akan dimulai dari posisi awal. Jika Count lebih besar dari nol, pencarian akan diteruskan mulai dari akhir.

pDelta

Jenis: long*

Jumlah karakter titik penyisipan dipindahkan, ditambah 1 untuk kecocokan jika Jumlah lebih besar dari nol, dan –1 untuk kecocokan jika Hitung kurang dari nol. Penunjuk bisa null.

Mengembalikan nilai

Jenis: HRESULT

Metode mengembalikan nilai HRESULT . Jika metode berhasil, metode akan mengembalikan S_OK. Jika metode gagal, metode mengembalikan salah satu kode kesalahan berikut. Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan di COM.

Menampilkan kode	Deskripsi
E_INVALIDARG	Cset tidak valid.
S_FALSE	Kegagalan karena alasan lain.

Keterangan

Jika tidak ada karakter yang cocok, rentang tidak berubah.

Gerakan yang dijelaskan oleh ITextRange::MoveUntil logis daripada geometris. Artinya, gerakan adalah menuju akhir atau menuju awal cerita. Tergantung pada bahasanya, pindah ke akhir cerita bisa bergerak ke kiri atau bergerak ke kanan.

Untuk informasi selengkapnya, lihat diskusi di ITextRange dan bagian Keterangan ITextRange::Move.

Metode ITextRange::MoveStartUntil dan ITextRange::MoveEndUntil masing-masing memindahkan awal dan akhir, hingga menemukan karakter pertama yang juga ada dalam set yang ditentukan oleh parameter Cset .

Metode ITextRange::MoveUntil mirip dengan ITextRange::MoveWhile, tetapi ada dua perbedaan. Pertama, MoveUntil memindahkan titik penyisipan hingga menemukan karakter pertama milik kumpulan karakter yang ditentukan oleh Cset. Kedua, di MoveUntil karakter yang cocok dihitung sebagai karakter tambahan dalam nilai yang dikembalikan dalam pDelta. Ini memungkinkan Anda tahu bahwa karakter di salah satu ujung rentang atau yang lain milik Cset meskipun titik penyisipan tetap berada di salah satu rentang berakhir.

Misalnya, misalkan rentang, r, adalah titik penyisipan. Untuk melihat apakah karakter di r (yaitu, yang diberikan oleh r.GetChar()) ada di Cset, panggil

r.MoveUntil(Cset, 1)

Jika karakter berada di Cset, nilai yang dikembalikan adalah 1 dan titik penyisipan tidak bergerak. Demikian pula, untuk melihat apakah karakter sebelumnya r ada di Cset, panggil

r.MoveUntil(Cset, -1)

Jika karakter berada di Cset, nilai yang dikembalikan adalah –1.

Sub-rutin Microsoft Visual Basic for Applications (VBA) berikut mencetak semua angka dalam cerita yang diidentifikasi oleh rentang, r.

Sub PrintNumbers (r As ITextRange)
   r.SetRange 0, 0    // r = insertion point at start of story
   While r.MoveUntil(C1_DIGIT)  // Move r to 1st digit in next number
      r.MoveEndWhile C1_DIGIT  // Select number (span of digits)
      Print r    // Print it
   Wend
End Sub

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