Metode ITfInsertAtSelection::InsertEmbeddedAtSelection (msctf.h)

Artikel
08/24/2023

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. Pilihan.

Nilai kembali

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