Bagikan melalui


ITfRange::Metode ShiftEnd (msctf.h)

Memindahkan jangkar akhir rentang.

Sintaks

HRESULT ShiftEnd(
  [in]  TfEditCookie      ec,
  [in]  LONG              cchReq,
  [out] LONG              *pcch,
  [in]  const TF_HALTCOND *pHalt
);

Parameter

[in] ec

Berisi cookie edit yang mengidentifikasi konteks edit. Ini diperoleh dari ITfDocumentMgr::CreateContext atau ITfEditSession::D oEditSession.

[in] cchReq

Berisi jumlah karakter yang digeser oleh jangkar akhir. Nilai negatif menyebabkan jangkar bergerak mundur dan nilai positif menyebabkan jangkar bergerak maju.

[out] pcch

Penunjuk ke nilai LONG yang menerima jumlah karakter yang digeser jangkar.

[in] pHalt

Penunjuk ke struktur TF_HALTCOND yang berisi kondisi pada shift. Parameter ini bersifat opsional dan dapat berupa NULL.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Deskripsi
S_OK
Metode berhasil.
E_FAIL
Terjadi kesalahan yang tidak ditentukan.
E_INVALIDARG
Satu atau beberapa parameter tidak valid.
TF_E_NOLOCK
Konteks edit yang diidentifikasi oleh ec tidak memiliki kunci baca-saja.

Keterangan

Posisi awal dan akhir rentang disebut jangkar.

Metode ini tidak dapat memindahkan jangkar di luar batas wilayah. Jika pergeseran mencapai batas wilayah, jumlah karakter yang benar-benar digeser akan kurang dari yang diminta. ITfRange::ShiftEndRegion digunakan untuk menggeser jangkar ke wilayah yang berdekatan.

Jika operasi shift menyebabkan jangkar akhir rentang bergerak melewati jangkar mulai, jangkar mulai dipindahkan ke lokasi yang sama dengan jangkar akhir.

ITfRange::ShiftEnd bisa menjadi operasi yang panjang. Untuk performa yang lebih baik, gunakan ITfRange::ShiftEndToRange jika memungkinkan.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header msctf.h
DLL Msctf.dll
Redistribusi TSF 1.0 di Windows 2000 Professional

Lihat juga

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::ShiftEndRegion

ITfRange::ShiftStart

TF_HALTCOND