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 .

Mengembalikan 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