ITextRange::Metode MoveEndUntil (tom.h)

Artikel
03/13/2024

Memindahkan akhir rentang ke posisi karakter karakter pertama yang ditemukan yang ada di kumpulan karakter yang ditentukan oleh Cset, asalkan karakter ditemukan dalam karakter Hitung dari akhir rentang.

Sintaks

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

Parameter

Cset

Jenis: VARIAN*

Karakter yang diatur untuk digunakan dalam kecocokan. Ini bisa menjadi string karakter eksplisit atau indeks set karakter. Untuk informasi selengkapnya, lihat Kumpulan Pencocokan Karakter.

Count

Jenis: panjang

Jumlah karakter maksimum yang akan dilewati. Nilai defaultnya adalah tomForward, yang mencari di akhir cerita. Jika Count lebih besar dari nol, pencarian bergerak maju (menuju akhir cerita). Jika Count kurang dari nol, pencarian bergerak mundur (ke awal cerita). Jika Count adalah nol, posisi akhir tidak berubah.

pDelta

Jenis: panjang*

Jumlah karakter aktual yang dipindahkan oleh akhir rentang, ditambah 1 untuk kecocokan jika Hitungan lebih besar dari nol, dan –1 untuk kecocokan jika Hitungan kurang dari nol. Nilainya 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
Nilai	Makna
E_INVALIDARG	Cset tidak valid.
S_FALSE	Kegagalan karena alasan lain.

Keterangan

Jika tidak ada karakter dari set yang ditentukan oleh Cset yang ditemukan dalam Posisi hitungan akhir rentang, rentang dibiarkan tidak berubah. Jika akhir baru mendahului awal lama, awal baru diatur sama dengan akhir baru.

Gerakan yang dijelaskan oleh ITextRange::MoveEndUntil logis daripada geometris. Artinya, gerakan 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 ITextRange dan ITextRange::Move.

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