Metode ITfInsertAtSelection::InsertEmbeddedAtSelection (msctf.h)

Metode ITfInsertAtSelection::InsertEmbeddedAtSelection menyisipkan objek IDataObject pada titik pemilihan atau penyisipan.

Sintaks

HRESULT InsertEmbeddedAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  IDataObject  *pDataObject,
  [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:

TF_IAS_NOQUERY

Parameter ppRangeadalah NULL saat keluar.

TF_IAS_QUERYONLY

Konteks tidak dimodifikasi tetapi parameter ppRange diatur seolah-olah sisipan terjadi. Akses baca-saja sudah cukup. Jika bendera ini tidak diatur, parameter ec harus memiliki akses baca/tulis.

TF_IAS_NO_DEFAULT_COMPOSITION

Manajer TSF tidak membuat komposisi default jika komposisi diperlukan. Pemanggil harus membuat objek komposisi yang mencakup teks yang disisipkan sebelum melepaskan kunci konteks.

[in] pDataObject

Arahkan ke objek untuk disisipkan.

[out] ppRange

Posisi objek yang disisipkan. Opsional.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Deskripsi
S_OK
Metode berhasil.
TF_E_NOLOCK
Parameter ec adalah cookie edit yang tidak valid.
TF_E_DISCONNECTED
Objek konteks tidak ada di tumpukan dokumen.
TS_E_NOSELECTION
Konteks tidak memiliki pilihan.
TS_E_READONLY
Pilihan bersifat baca-saja.
TF_E_FORMAT
Pemilik konteks tidak dapat menangani objek jenis yang disediakan oleh parameter pDataObject .

Keterangan

Penelepon dapat menggunakan metode ITfQueryEmbedded::QueryInsertEmbedded untuk menentukan apakah jenis objek tertentu kemungkinan akan diterima oleh metode ini.

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

Persyaratan

   
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::InsertTextAtSelection

ITfQueryEmbedded::QueryInsertEmbedded