Metode ITextRange::EndOf (tom.h)

Artikel
03/09/2024

Memindahkan rentang ini berakhir ke akhir Unit tumpang tindih terakhir dalam rentang.

Sintaks

HRESULT EndOf(
  long Unit,
  long Extend,
  long *pDelta
);

Parameter

Unit

Jenis: panjang

Unit yang akan digunakan. Nilai default: tomWord. Untuk daftar nilai Unit lainnya, lihat diskusi di bawah ITextRange.

Extend

Jenis: panjang

Indikator bagaimana pergeseran rentang berakhir adalah untuk melanjutkan. Ini bisa menjadi salah satu dari berikut ini.

0 atau tomMove	Ciutkan rentang yang tidak dibuat ke Akhir rentang asli dengan memindahkan titik penyisipan. Ini adalah default.
1 (atau tomExtend)	Memindahkan Akhir ke akhir Unit yang tumpang tindih. Tidak memindahkan Mulai.

pDelta

Jenis: panjang*

Jumlah karakter yang dilewati Akhir dipindahkan. Nilai penunjuk bisa null. Saat dikembalikan, nilai pDelta adalah jumlah karakter titik penyisipan atau Akhir dipindahkan ditambah 1 jika ciutkan terjadi pada entri Berakhir. Jika rentang menyertakan CR akhir (pengembalian pengangkutan) (di akhir cerita) dan Perluas = tomMove, maka pDelta diatur ke –1, untuk menunjukkan bahwa keruntuhan terjadi sebelum akhir rentang (karena titik penyisipan tidak dapat ada di luar CR akhir).

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_NOTIMPL	Unit tidak didukung.
S_FALSE	Kegagalan karena alasan lain.

Keterangan

Sebagai perbandingan, metode ITextRange::StartOf memindahkan rentang berakhir ke awal Unit tumpang tindih pertama dalam rentang. Catatan, metode ITextRange::StartOf dan ITextRange::EndOf berbeda dari metode HomeKey dan EndKey yang terakhir diperluas dari ujung aktif, sedangkan ITextRange::StartOf memperluas dari Mulai dan ITextRange::EndOf meluas dari Akhir. Jika rentang adalah titik penyisipan pada batas antara Units, ITextRange::EndOf tidak mengubah Akhir. Secara khusus, memanggil ITextRange::EndOf (tomCharacter, *, *) tidak mengubah Akhir kecuali untuk titik penyisipan di awal cerita.

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