Metode ITfInsertAtSelection::InsertTextAtSelection (msctf.h)

  • Artikel

Sisipkan teks pada titik pemilihan atau penyisipan.

Sintaks

HRESULT InsertTextAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  const WCHAR  *pchText,
  [in]  LONG         cch,
  [out] ITfRange     **ppRange
);

Parameter

[in] ec

Mengidentifikasi konteks edit. Ini diperoleh dari ITfDocumentMgr::CreateContext atau ITfEditSession::D oEditSession.

[in] dwFlags

Bidang bit dengan salah satu nilai berikut.

Nilai Makna
TF_IAS_NOQUERY
 ppRange adalah NULL. Bendera ini tidak dapat digabungkan dengan bendera TF_IAS_QUERYONLY.
TF_IAS_QUERYONLY
 Konteks tidak dimodifikasi, tetapi ppRange diatur seolah-olah sisipan telah terjadi. Akses baca-saja sudah cukup. Jika bendera ini tidak diatur, ec harus memiliki akses baca/tulis. Bendera ini tidak dapat digabungkan dengan bendera TF_IAS_NOQUERY.
TF_IAS_NO_DEFAULT_COMPOSITION
 Manajer tidak akan membuat komposisi default jika komposisi diperlukan. Pemanggil harus membuat objek komposisi yang mencakup teks yang disisipkan sebelum melepaskan kunci konteks.

[in] pchText

Menentukan teks yang akan disisipkan.

[in] cch

Menentukan jumlah karakter teks dalam pchText.

[out] ppRange

Menerima posisi objek yang disisipkan.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Deskripsi
S_OK
 Metode berhasil.
TF_E_NOLOCK
 Layanan teks tidak memiliki kunci dokumen
TF_E_DISCONNECTED
 Objek konteks tidak ada di tumpukan dokumen.
TS_E_NOSELECTION
 Konteks tidak memiliki pilihan.
TS_E_READONLY
 Pilihan bersifat baca-saja.

Keterangan

Untuk menyisipkan objek IDataObject alih-alih teks, gunakan ITfInsertAtSelection::InsertEmbeddedAtSelection.

Persyaratan

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

Lihat juga

IDataObject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertEmbeddedAtSelection