Metode ITextStoreACP::InsertTextAtSelection (textstor.h)

  • Artikel

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.

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 dapat null, dan struktur TS_TEXTCHANGE harus diisi. Gunakan bendera ini untuk melihat hasil penyisipan teks.
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. Anda tidak perlu mengisi struktur TS_TEXTCHANGE jika Anda menggunakan bendera ini.

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

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

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Deskripsi
S_OK
 Metode berhasil.
TS_E_NOLOCK
 Pemanggil tidak memiliki kunci pada dokumen.
E_INVALIDARG
 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

Lihat juga

Komposisi

ITextStoreACP

ITextStoreACPSink::OnTextChange

TF_IAS_* Konstanta

TS_TEXTCHANGE