Metode ITextStoreACP::InsertTextAtSelection (textstor.h)
Metode ITextStoreACP::InsertTextAtSelection menyisipkan teks pada titik penyisipan atau pilihan. Penelepon harus memiliki kunci baca/tulis pada dokumen sebelum menyisipkan teks.
Sintaks
HRESULT InsertTextAtSelection(
[in] DWORD dwFlags,
[in] const WCHAR *pchText,
[in] ULONG cch,
[out] LONG *pacpStart,
[out] LONG *pacpEnd,
[out] TS_TEXTCHANGE *pChange
);
Parameter
[in] dwFlags
Menentukan apakah parameter pacpStart dan pacpEnd dan struktur TS_TEXTCHANGE berisi hasil penyisipan teks.
Bendera TF_IAS_NOQUERY dan TF_IAS_QUERYONLY tidak dapat digabungkan.
[in] pchText
Arahkan ke string untuk disisipkan dalam dokumen. String dapat dihentikan NULL .
[in] cch
Menentukan panjang teks.
[out] pacpStart
Penunjuk ke posisi karakter aplikasi awal tempat penyisipan teks terjadi.
[out] pacpEnd
Penunjuk ke posisi karakter aplikasi akhir tempat penyisipan teks terjadi. Nilai parameter ini 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. |
|
Pemanggil tidak memiliki kunci pada dokumen. |
|
Parameter pchText tidak valid. |
Keterangan
Nilai pacpStart dan parameter pacpEnd bergantung pada bagaimana aplikasi klien menyisipkan teks ke dalam dokumen. Misalnya, jika aplikasi mengatur kursor di awal teks yang disisipkan setelah penyisipan teks, maka nilai untuk parameter pacpStart dan pacpEnd sama dengan anggota acpStart dari struktur TS_TEXTCHANGE .
Aplikasi tidak boleh memanggil metode ITextStoreACPSink::OnTextChange sebagai respons terhadap metode ini.
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 |