Metode ITextStoreAnchor::QueryInsert (textstor.h)

  • Artikel

Metode ITextStoreAnchor::QueryInsert menentukan apakah jangkar awal dan akhir yang ditentukan valid. Gunakan metode ini untuk menyesuaikan pengeditan ke dokumen sebelum Anda menjalankan pengeditan. Metode tidak boleh mengembalikan nilai di luar rentang dokumen.

Sintaks

HRESULT QueryInsert(
  [in]  IAnchor *paTestStart,
  [in]  IAnchor *paTestEnd,
  [in]  ULONG   cch,
  [out] IAnchor **ppaResultStart,
  [out] IAnchor **ppaResultEnd
);

Parameter

[in] paTestStart

Menerima penunjuk ke jangkar awal untuk teks yang disisipkan.

[in] paTestEnd

Menerima penunjuk ke jangkar akhir untuk teks yang disisipkan. Ini sama dengan paTestStart jika teks disisipkan pada titik alih-alih mengganti teks yang dipilih.

[in] cch

Panjang teks pengganti.

[out] ppaResultStart

Arahkan ke objek jangkar baru di lokasi awal untuk teks yang disisipkan. Jika nilai parameter ini ADALAH NULL, maka teks tidak dapat disisipkan pada posisi yang ditentukan. Jangkar ini tidak dapat berada di luar dokumen.

[out] ppaResultEnd

Arahkan ke objek jangkar baru di lokasi akhir untuk teks yang disisipkan. Jika nilai parameter ini ADALAH NULL, maka teks tidak dapat disisipkan pada posisi yang ditentukan. Jangkar ini tidak dapat berada di luar dokumen.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Deskripsi
S_OK
 Metode berhasil.
E_FAIL
 Terjadi kesalahan yang tidak ditentukan.
E_INVALIDARG
 Parameter paTestStart atau paTestEnd tidak valid.
E_OUTOFMEMORY
 Upaya untuk membuat instans ppaResultStart dan/atau ppaResultEnd anchors gagal.

Keterangan

Nilai ppaResultStart dan ppaResultEnd bergantung pada bagaimana aplikasi menyisipkan teks ke dalam dokumen. Jika ppaResultStart dan ppaResultEnd sama dengan paTestStart, kursor berada di awal teks yang disisipkan setelah penyisipan. Jika ppaResultStart dan ppaResultEnd sama dengan paTextEnd, kursor berada di akhir teks yang disisipkan setelah penyisipan.

Persyaratan

Persyaratan Nilai
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