ITextRange::MoveStartUntil method (tom.h)
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 |
---|---|
|
Cset tidak valid. |
|
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 |
Lihat juga
Konseptual
Referensi