ITextStoreAnchor::InsertTextAtSelection method (textstor.h)

Menyisipkan teks pada titik penyisipan atau pilihan.

Sintaks

HRESULT InsertTextAtSelection(
  [in]  DWORD       dwFlags,
  [in]  const WCHAR *pchText,
  [in]  ULONG       cch,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

Parameter

[in] dwFlags

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

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. Teks panjang nol dapat disisipkan.

[in] pchText

Arahkan ke string untuk disisipkan dalam dokumen. String dapat dihentikan NULL .

[in] cch

Menentukan panjang teks.

[out] ppaStart

Arahkan ke objek jangkar di awal penyisipan teks.

[out] ppaEnd

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

Menampilkan nilai

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.
TS_E_NOLOCK	Pemanggil tidak memiliki kunci pada dokumen.

Persyaratan

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

Lihat juga

Komposisi

ITextStoreAnchor

ITextStoreAnchorSink::OnTextChange

TF_IAS_* Konstanta

TS_TEXTCHANGE