Metode ITextStoreACP2::QueryInsert (textstor.h)
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.
Mengembalikan nilai
Metode ini dapat mengembalikan salah satu nilai ini.
Nilai | Deskripsi |
---|---|
|
Metode berhasil. |
|
Terjadi kesalahan yang tidak ditentukan. |
|
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 8 [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2012 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | textstor.h |
DLL | Msctf.dll |