Metode ITextRange::SetEnd (tom.h)

Artikel
08/26/2023

Mengatur posisi akhir rentang.

Sintaks

HRESULT SetEnd(
  long cpLim
);

Parameter

cpLim

Jenis: panjang

Posisi akhir baru.

Nilai kembali

Jenis: HRESULT

Metode mengembalikan nilai HRESULT . Jika metode berhasil, metode akan mengembalikan S_OK. Jika metode gagal, metode akan mengembalikan S_FALSE.

Keterangan

Jika posisi akhir baru kurang dari posisi awal, metode ini juga mengatur posisi awal ke cp; yaitu, rentang menjadi titik penyisipan.

Jika rentang ini sebenarnya adalah pilihan, posisi akhir menjadi akhir aktif dan, jika tampilan tidak dibekukan, maka akan digulir ke tampilan.

ITextRange::SetStart mengatur posisi mulai rentang dan ITextRange::SetRange mengatur kedua rentang berakhir secara bersamaan. Untuk mengonversi rentang nondegenerasi, r, menjadi degenerasi satu (titik penyisipan) pada posisi awal, gunakan

r.End = r.Start

Demikian pula, r.Start = r.End mengonversi r menjadi titik penyisipan di posisi akhir.

Untuk menambahkan 1 ke posisi akhir, kecuali jika berada di akhir cerita, gunakan:

r.End = r.End + 1

Ini juga membuat posisi akhir akhir aktif, dan dapat mengubah rentang degenerasi menjadi yang tidak degenerasi.

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