Metode ITextStoreACP2::InsertEmbeddedAtSelection (textstor.h)
Menyisipkan 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 |
---|---|
|
Penyisipan teks akan terjadi, dan parameter pacpStart dan pacpEnd akan berisi hasil penyisipan teks. Struktur TS_TEXTCHANGE harus diisi dengan bendera ini. |
|
Teks disisipkan, nilai parameter pacpStart dan pacpEnd dapat null, dan struktur TS_TEXTCHANGE harus diisi. Gunakan bendera ini jika hasil penyisipan teks tidak diperlukan. |
|
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 untuk disisipkan.
[out] pacpStart
Penunjuk 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.
Mengembalikan nilai
Metode ini dapat mengembalikan salah satu nilai ini.
Nilai | Deskripsi |
---|---|
|
Metode berhasil. |
|
Parameter pchText tidak valid. |
|
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 8 [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2012 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | textstor.h |
DLL | Msctf.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk