ITextStoreACP::InsertEmbeddedAtSelection method (textstor.h)

Artikel
08/26/2023

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

Sintaks

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD         dwFlags,
  [in]  IDataObject   *pDataObject,
  [out] LONG          *pacpStart,
  [out] LONG          *pacpEnd,
  [out] TS_TEXTCHANGE *pChange
);

Parameter

[in] dwFlags

Menentukan apakah parameter pacpStart dan pacpEnd dan struktur TS_TEXTCHANGE akan berisi hasil penyisipan objek.

Bendera TF_IAS_NOQUERY dan TF_IAS_QUERYONLY tidak dapat digabungkan.

Nilai	Makna
0	Penyisipan teks akan terjadi, dan parameter pacpStart dan pacpEnd akan berisi hasil penyisipan teks. Struktur TS_TEXTCHANGE harus diisi dengan bendera ini.
TF_IAS_NOQUERY	Teks disisipkan, nilai parameter pacpStart dan pacpEnd bisa NULL, dan struktur TS_TEXTCHANGE harus diisi. Gunakan bendera ini jika hasil penyisipan teks tidak diperlukan.
TF_IAS_QUERYONLY	Teks tidak disisipkan, dan nilai untuk parameter pacpStart dan pacpEnd berisi hasil penyisipan teks. Nilai parameter ini bergantung pada bagaimana aplikasi mengimplementasikan penyisipan teks ke dalam dokumen. Untuk informasi lebih lanjut, lihat bagian Keterangan. Gunakan bendera ini untuk melihat hasil penyisipan teks tanpa benar-benar menyisipkan teks, misalnya, untuk memprediksi hasil penciutan atau menyesuaikan pilihan. Anda tidak perlu mengisi struktur TS_TEXTCHANGE dengan bendera ini.

[in] pDataObject

Arahkan ke objek IDataObject yang akan disisipkan.

[out] pacpStart

Arahkan ke posisi karakter aplikasi awal tempat penyisipan objek akan terjadi.

[out] pacpEnd

Penunjuk ke posisi karakter aplikasi akhir tempat penyisipan objek akan terjadi. Nilai parameter ini akan sama dengan nilai parameter pacpStart untuk titik penyisipan.

[out] pChange

Arahkan ke struktur TS_TEXTCHANGE dengan anggota berikut.

Nilai	Makna
acpStart	Posisi karakter aplikasi awal sebelum objek dimasukkan ke dalam dokumen.
acpOldEnd	Posisi karakter aplikasi akhir sebelum objek dimasukkan ke dalam dokumen. Nilai ini sama dengan acpStart untuk titik penyisipan. Jika nilai ini berbeda dari acpStart, maka teks dipilih sebelum penyisipan objek.
acpNewEnd	Posisi karakter aplikasi akhir setelah penyisipan objek berlangsung.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Parameter pchText tidak valid.
TS_E_NOLOCK	Pemanggil tidak memiliki kunci pada dokumen.

Keterangan

Nilai parameter pacpStart dan pacpEnd bergantung pada bagaimana aplikasi klien menyisipkan objek ke dalam dokumen. Misalnya, jika aplikasi mengatur kursor di awal objek setelah penyisipan objek, maka nilai parameter pacpStart dan pacpEnd sama dengan anggota acpStart dari struktur TS_TEXTCHANGE .

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

Lihat juga