ITextRange::MoveStartUntil method (tom.h)

Artikel
03/09/2024

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

Sintaks

HRESULT MoveStartUntil(
  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 Set Kecocokan Karakter.

Count

Jenis: panjang

Jumlah maksimum karakter yang akan dilewati. Nilai defaultnya adalah tomForward, yang mencari di akhir cerita. Jika Count lebih besar dari nol, pencarian akan diteruskan—ke akhir cerita—dan jika Hitungan kurang dari nol, pencarian mundur—ke awal. Jika Count adalah nol, posisi mulai tidak berubah.

pDelta

Jenis: long*

Jumlah karakter aktual awal rentang dipindahkan, ditambah 1 untuk kecocokan jika Jumlah 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
E_INVALIDARG	Cset tidak valid.
S_FALSE	Kegagalan karena alasan lain.

Keterangan

Jika tidak ada karakter dari Cset yang ditemukan dalam posisi Hitung dari posisi mulai, rentang dibiarkan tidak berubah.

Jika awal baru mengikuti akhir lama, akhir baru diatur sama dengan awal baru.

Gerakan yang dijelaskan oleh ITextRange::MoveStartUntil adalah 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 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