ITfRange::AdjustForInsert method (msctf.h)

Artikel
03/05/2024

Metode ITfRange::AdjustForInsert memperluas atau mengontrak rentang teks untuk menyesuaikan penyisipan teks.

Sintaks

HRESULT AdjustForInsert(
  [in]  TfEditCookie ec,
  [in]  ULONG        cchInsert,
  [out] BOOL         *pfInsertOk
);

Parameter

[in] ec

Edit cookie yang diperoleh dari ITfDocumentMgr::CreateContext atau ITfEditSession::D oEditSession.

[in] cchInsert

Jumlah karakter teks yang disisipkan. Jumlah ini digunakan dalam futurecall ke ITfRange::SetText. Jika jumlah karakter tidak diketahui, 0 dapat digunakan.

[out] pfInsertOk

Penunjuk ke bendera yang menunjukkan apakah pemilik konteks akan menerima (TRUE) atau menolak (FALSE) penyisipan.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Metode gagal.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.
E_NOTIMPL	Aplikasi tidak dapat menggantikan pilihan.
TF_E_NOLOCK	Nilai dalam parameter ec adalah cookie yang tidak valid, atau pemanggil tidak memiliki kunci baca-saja.

Keterangan

Metode ini harus digunakan untuk menyiapkan rentang untuk memulai komposisi baru, sebelum pengeditan dimulai. Ini harus digunakan hanya ketika teks tidak disisipkan pada pilihan saat ini. ITFInsertAtSelection:InsertTextAtSelection atau ITfInsertAtSelection::InsertEmbeddedAtSelection adalah metode yang benar untuk digunakan saat teks disisipkan pada pilihan saat ini.

Pemilik konteks dapat menggunakan metode ini untuk mempertahankan perilaku dan membantu mempertahankan pengalaman pengguna yang konsisten. Misalnya, karakter atau objek tertentu dalam konteks dapat dipertahankan dari modifikasi, atau overtyping dapat didukung.

Metode ini tidak diperlukan saat memodifikasi komposisi yang ada. Dapat diterima untuk memanggil ITfRange::SetText secara langsung untuk mengubah teks yang sebelumnya dimasukkan oleh pemanggil.

Saat keluar, jika *pfInsertOk diatur ke FALSE, panggilan mendatang ke ITfRange::SetText atau ITfRange::InsertEmbedded dengan rentang ini kemungkinan gagal. Jika tidak, *pfInsertOk akan diatur ke TRUE, dan jangkar mulai rentang atau jangkar akhir dapat diposisikan ulang sesuai kebijaksanaan pemilik konteks.

Persyaratan

Persyaratan	Nilai
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