ITfRange::Metode ShiftStart (msctf.h)
Memindahkan jangkar awal rentang.
Sintaks
HRESULT ShiftStart(
[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 jangkar awal yang digeser. Nilai negatif menyebabkan jangkar bergerak mundur dan nilai positif menyebabkan jangkar bergerak maju.
[out] pcch
Penunjuk ke nilai LONG yang menerima jumlah karakter jangkar digeser.
[in] pHalt
Penunjuk ke struktur TF_HALTCOND yang berisi kondisi tentang pergeseran. Parameter ini bersifat opsional dan dapat berupa NULL.
Nilai kembali
Metode ini dapat mengembalikan salah satu nilai ini.
Nilai | Deskripsi |
---|---|
|
Metode berhasil. |
|
Satu atau beberapa parameter tidak valid. |
|
Terjadi kesalahan yang tidak ditentukan. |
|
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::ShiftStartRegion digunakan untuk menggeser jangkar ke wilayah yang berdekatan.
Jika operasi shift menyebabkan jangkar mulai rentang bergerak melewati jangkar akhir, jangkar akhir dipindahkan ke lokasi yang sama dengan jangkar awal.
ITfRange::ShiftStart bisa menjadi operasi yang panjang. Untuk performa yang lebih baik, gunakan ITfRange::ShiftStartToRange 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 |