ITextRange::MoveStartWhile method (tom.h)

Artikel
03/13/2024

Memindahkan posisi awal rentang baik karakter Hitung , atau hanya melewati semua karakter berdekatan yang ditemukan dalam kumpulan karakter yang ditentukan oleh Cset, mana yang kurang.

Sintaks

HRESULT MoveStartWhile(
  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 tempat posisi mulai dipindahkan. Parameter ini dapat berupa null.

Nilai kembali

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 awal baru mengikuti akhir lama, akhir baru diatur sama dengan awal baru.

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