Metode ITextRange::SetStart (tom.h)

Artikel
03/09/2024

Mengatur posisi karakter untuk awal rentang ini.

Sintaks

HRESULT SetStart(
  [in] long cpFirst
);

Parameter

[in] cpFirst

Jenis: panjang

Posisi karakter baru untuk awal rentang.

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

Perhatikan bahwa jika cpFirst lebih besar dari posisi akhir rentang, metode ini mengatur posisi akhir yang sama dengan cpFirst, menjadikan rentang titik penyisipan. Jika rentang ini adalah pilihan, posisi mulai menjadi akhir aktif dan digulir ke tampilan jika tampilan tidak dibekukan.

ITextRange::SetEnd mengatur posisi akhir rentang, dan ITextRange::SetRange mengatur kedua rentang berakhir secara bersamaan. Contoh berikut menunjukkan cara mengonversi rentang nondegenerasi menjadi rentang degenerasi (titik penyisipan).

range.End = range.Start

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

Contoh berikut menambahkan 1 ke posisi akhir, jika tidak ada di akhir cerita.

range.End = range.End + 1

Ini juga membuat posisi akhir akhir dari rentang 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