Metode ITextStoreACP::QueryInsert (textstor.h)

Artikel
08/26/2023

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

Sintaks

HRESULT QueryInsert(
  [in]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

Parameter

[in] acpTestStart

Memulai posisi karakter aplikasi untuk teks yang disisipkan.

[in] acpTestEnd

Mengakhiri posisi karakter aplikasi untuk teks yang disisipkan. Nilai ini sama dengan acpTextStart jika teks disisipkan pada titik alih-alih mengganti teks yang dipilih.

[in] cch

Panjang teks pengganti.

[out] pacpResultStart

Mengembalikan posisi karakter aplikasi awal baru dari teks yang disisipkan. Jika parameter ini NULL, maka teks tidak dapat disisipkan pada posisi yang ditentukan. Nilai ini tidak boleh berada di luar rentang dokumen.

[out] pacpResultEnd

Mengembalikan posisi karakter aplikasi akhir baru dari teks yang disisipkan. Jika parameter ini NULL, maka pacpResultStart diatur ke NULL dan teks tidak dapat disisipkan pada posisi yang ditentukan. Nilai ini tidak boleh berada di luar rentang dokumen.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_INVALIDARG	Parameter acpTestStart atau acpTestEnd tidak valid.

Keterangan

Nilai pacpResultStart dan pacpResultEnd bergantung pada bagaimana aplikasi menyisipkan teks ke dalam dokumen. Jika pacpResultStart dan pacpResultEnd sama dengan acpTextStart, kursor berada di awal teks yang disisipkan setelah penyisipan. Jika pacpResultStart dan pacpResultEnd sama dengan acpTextEnd, kursor berada di akhir teks yang disisipkan setelah penyisipan. Jika perbedaan antara pacpResultStart dan pacpResultEnd sama dengan panjang teks yang disisipkan, teks yang disisipkan disorot setelah penyisipan.

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

Bagikan melalui