ITextRange::Metode StartOf (tom.h)

Artikel
03/03/2024

Memindahkan rentang berakhir ke awal Unit pertama yang tumpang tindih dalam rentang.

Sintaks

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

Parameter

Unit

Jenis: panjang

Unit yang digunakan dalam operasi pemindahan. Untuk daftar nilai Unit , lihat diskusi di bawah ITextRange.

Extend

Jenis: panjang

Cara memindahkan ujung rentang. Ini bisa menjadi salah satu nilai berikut.

0 (atau tomMove)	Ciutkan rentang nondegenerasi ke posisi mulai dengan memindahkan titik penyisipan. Ini adalah default.
1 (atau tomExtend)	Memindahkan posisi awal ke awal Unit yang tumpang tindih. Tidak memindahkan posisi akhir.

pDelta

Jenis: long*

Penunjuk ke variabel yang menerima jumlah karakter tempat posisi mulai dipindahkan. Batasan bisa null. Saat dikembalikan, pDelta adalah jumlah karakter yang ditandatangani bahwa titik penyisipan atau posisi mulai dipindahkan. Nilai ini selalu kurang dari atau sama dengan nol, karena gerakan selalu menuju awal cerita.

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

Jika rentang adalah titik penyisipan pada batas antara Units, ITextRange::StartOf tidak mengubah posisi mulai.

Metode ITextRange::StartOf dan ITextRange::EndOf berbeda dari metode HomeKey dan EndKey yang terakhir meluas dari ujung aktif, sedangkan ITextRange::StartOf meluas dari posisi awal dan ITextRange::EndOf meluas dari posisi akhir.

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