ITextStoreAnchor::InsertEmbeddedAtSelection method (textstor.h)

Artikel
08/26/2023

Metode ITextStoreAnchor::InsertEmbeddedAtSelection menyisipkan objek IDataObject pada titik penyisipan atau pilihan. Klien yang memanggil metode ini harus memiliki kunci baca/tulis sebelum menyisipkan IDataObject ke dalam aliran teks.

Sintaks

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD       dwFlags,
  [in]  IDataObject *pDataObject,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

Parameter

[in] dwFlags

Menentukan apakah parameter paStart dan paEnd akan berisi hasil penyisipan objek.

Bendera TF_IAS_NOQUERY dan TF_IAS_QUERYONLY tidak dapat digabungkan.

Nilai	Makna
TF_IAS_NOQUERY	Teks disisipkan, dan nilai parameter ppaStart dan ppaEnd bisa NULL. Gunakan bendera ini jika hasil penyisipan teks tidak diperlukan.
TF_IAS_QUERYONLY	Teks tidak disisipkan, dan jangkar ppaStart dan ppaEnd berisi hasil penyisipan teks. Nilai parameter ini bergantung pada bagaimana aplikasi mengimplementasikan penyisipan teks ke dalam dokumen. Gunakan bendera ini untuk melihat hasil penyisipan teks tanpa benar-benar menyisipkan teks, misalnya, untuk memprediksi hasil penciutan atau menyesuaikan pilihan.

[in] pDataObject

Arahkan ke objek IDataObject yang akan disisipkan.

[out] ppaStart

Arahkan ke objek jangkar di awal penyisipan objek.

[out] ppaEnd

Arahkan ke objek jangkar di akhir penyisipan objek. Untuk titik penyisipan, nilai parameter ini akan sama dengan nilai parameter ppaStart .

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Metode ini tidak dapat membuat instans salah satu jangkar paStart atau paEnd.
E_INVALIDARG	Parameter pchText tidak valid.
E_OUTOFMEMORY	Metode ini tidak dapat membuat instans salah satu jangkar paStart atau paEnd.
TS_E_NOLOCK	Pemanggil tidak memiliki kunci pada dokumen.

Keterangan

Klien harus menggunakan metode ini untuk menyisipkan objek ke dalam aliran teks, karena konstanta TS_CHAR_EMBEDDED tidak dapat diteruskan ke ITextStoreAnchor::SetText.

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	textstor.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional