ITextSelection::Metode EndKey (tom.h)

Artikel
26/08/2023

Meniup fungsionalitas kunci Akhir.

Sintaks

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

Parameter

Unit

Jenis: panjang

Unit yang akan digunakan. Ini bisa menjadi salah satu dari berikut ini.

Nilai	Makna
tomLine	Bergantung pada Perluas, itu memindahkan titik penyisipan atau ujung aktif ke akhir baris terakhir dalam pilihan. Ini adalah default.
tomStory	Bergantung pada Perluas, ini memindahkan titik penyisipan atau ujung aktif ke akhir baris terakhir dalam cerita.
tomColumn	Bergantung pada Perluas, ini memindahkan titik penyisipan atau ujung aktif ke akhir kolom terakhir dalam pilihan. Ini hanya tersedia jika mesin TOM mendukung tabel.
tomRow	Bergantung pada Perluas, ini memindahkan titik penyisipan atau ujung aktif ke akhir baris terakhir dalam pilihan. Ini hanya tersedia jika mesin TOM mendukung tabel.

Extend

Jenis: panjang

Bendera yang menunjukkan cara mengubah pilihan. Jika Perluas nol (atau tomMove), metode akan menciutkan pilihan ke titik penyisipan. Jika Extend adalah 1 (atau tomExtend), metode memindahkan akhir aktif dan meninggalkan ujung lainnya saja. Nilai defaultnya adalah nol.

pDelta

Jenis: panjang*

Penunjuk ke variabel yang menerima jumlah karakter yang dipindahkan oleh titik penyisipan atau akhir aktif. Parameter ini dapat berupa 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
E_INVALIDARG	Unit bukan tomLine maupun tomStory.
S_FALSE	Kegagalan karena alasan lain.

Keterangan

Pengaturan Perluas ke tomExtend (atau bukan nol) sesuai dengan tombol Shift yang ditekan. Mengatur Unit ke tomLine sesuai dengan tombol Ctrl yang tidak ditekan. Mengatur Unit ke tomStory ke Ctrl sedang ditekan. Parameter pDelta menerima jumlah karakter yang dipindahkan oleh titik penyisipan atau akhir aktif.

Metode ITextSelection::HomeKey dan ITextSelection::EndKey digunakan untuk meniru perilaku kunci Home/End standar.

Nilai tomLine menimbuhkan perilaku tombol Beranda atau Akhir tanpa tombol Ctrl ditekan, sementara tomStory menirukan perilaku dengan tombol Ctrl yang ditekan. Demikian pula, tomMove meniadakan perilaku tombol Beranda atau Akhir tanpa tombol Shift ditekan, sementara tomExtend meniadakan perilaku dengan tombol Shift ditekan. Jadi EndKey(tomStory) mengonversi pilihan menjadi titik penyisipan di akhir cerita terkait, sambil EndKey(tomStory, tomExtend) memindahkan akhir aktif pilihan ke akhir cerita dan meninggalkan ujung lainnya di tempatnya berada.

Metode HomeKey dan EndKey adalah metode logis seperti metode Move* , bukan metode arah. Dengan demikian, mereka bergantung pada bahasa yang terlibat. Misalnya, dalam teks Arab, HomeKey berpindah ke ujung kanan baris, sedangkan dalam teks bahasa Inggris, ia berpindah ke kiri. Dengan demikian, HomeKey dan EndKey berbeda dari metode MoveLeft dan MoveRight . Selain itu, perhatikan bahwa metode EndKey cukup berbeda dari properti Akhir , yang merupakan cp akhir pilihan. HomeKey dan EndKey juga berbeda dari metode StartOf dan EndOf karena meluas dari ujung aktif, sedangkan StartOf meluas dari Start dan EndOf meluas dari Akhir.

Persyaratan


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