ITextSelection::Metode MoveRight (tom.h)

Artikel
08/26/2023

Menggeneralisasi fungsionalitas tombol Panah Kanan.

Sintaks

HRESULT MoveRight(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

Parameter

Unit

Jenis: panjang

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

Nilai	Kombinasi kunci yang sesuai	Makna
tomCharacter	Panah Kanan	Pindahkan satu posisi karakter ke kanan. Ini adalah default.
tomWord	Ctrl+Panah Kanan	Pindahkan satu kata ke kanan.

Catatan, jika Hitungan kurang dari nol, gerakan berada di sebelah kiri.

Count

Jenis: panjang

Jumlah Unit yang akan dilewati. Nilai default adalah 1. Jika Count kurang dari nol, pergerakan berada di sebelah kiri.

Extend

Jenis: panjang

Bendera yang menunjukkan cara mengubah pilihan. Jika Perluas adalah nol (atau tomMove), metode akan menciutkan pilihan ke titik penyisipan di akhir aktif lalu memindahkannya. Jika Extend adalah 1 (atau tomExtend), metode memindahkan akhir aktif dan meninggalkan ujung lainnya saja. Nilai defaultnya adalah nol. Nilai Perluas bukan nol sesuai dengan tombol Shift yang ditekan selain kombinasi tombol yang dijelaskan dalam Unit.

pDelta

Jenis: long*

Jumlah unit aktual titik penyisipan atau akhir aktif dipindahkan ke kiri. Parameter ini dapat berupa null. Menciutkan pilihan, saat Perluas adalah 0, dihitung sebagai satu unit.

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

Keterangan

Metode pemindahan Microsoft WordBasic seperti CharRight, CharLeft, WordRight, dan WordLeft adalah hibrid yang dapat melakukan empat hal yang terkait erat dengan perilaku pengeditan tombol panah standar:

Pindahkan titik penyisipan saat ini jika tidak ada pilihan.
Pindahkan akhir aktif pilihan jika ada pilihan.
Ubah titik penyisipan menjadi pilihan dan sebaliknya.
Mengembalikan Boolean yang menyatakan apakah pergerakan terjadi.

Argumen ExtendmoveLeft dan MoveRight memungkinkan Anda konsisten dengan tiga item pertama di atas, dan pDelta adalah generalisasi keempat. Misalnya, dengan pilihan, s, yang terdiri dari satu rentang, Anda memiliki korespondensi berikut (untuk karakter kiri-ke-kanan).

ITextSelection	WordBasic	Fungsi
s.MoveRight tomWord, 1, 1	WordRight 1,1	Memindahkan satu kata akhir aktif ke kanan.
s.MoveLeft tomCharacter, 1, 1	CharLeft 1,1	Memindahkan satu karakter akhir aktif ke kiri.

Seperti dalam WordBasic, jika Hitungan kurang dari nol, makna kiri dan kanan dipertukarkan, itu MoveLeft (Unit, Count, Extend) setara dengan MoveRight(Unit, -Count, Extend).

Mirip dengan perilaku UI tombol WordBasic dan Panah Kanan, memanggil MoveRight(Unit, Count) pilihan degenerasi memindahkan titik penyisipan jumlah unit yang ditentukan. Pada rentang degenerasi, memanggil MoveRight(Unit, Count, 1) di mana Count lebih besar dari nol menyebabkan rentang menjadi nondegenerasi dengan ujung kanan menjadi akhir aktif.

Ketika Extend adalah tomExtend (atau bukan nol), MoveRight hanya memindahkan akhir aktif pilihan, meninggalkan ujung lain di tempatnya. Namun, jika Perluas sama dengan nol dan pilihan dimulai sebagai rentang nondegenerasi, MoveRight(Unit, Count) di mana Count lebih besar dari nol memindahkan ujung Count aktif - 1 unit ke kanan, lalu memindahkan ujung lainnya ke ujung aktif. Dengan kata lain, ini membuat titik penyisipan di akhir aktif. Menciutkan rentang dihitung sebagai satu unit. Dengan demikian, MoveRight(tomCharacter) mengonversi pilihan nondegenerasi menjadi pilihan degenerasi di ujung kanan pilihan. Di sini, Count memiliki nilai default 1 dan Extend memiliki nilai default nol. Contoh ini sesuai dengan menekan tombol Panah Kanan. MoveLeft dan MoveRight terkait dengan metode pemindahan ITextRange , tetapi berbeda karena secara eksplisit menggunakan akhir aktif (akhir dipindahkan dengan menekan tombol Shift).

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