Metode IInkAnalyzer::Abort
Membatalkan operasi analisis saat ini.
Sintaks
HRESULT Abort(
[out] IAnalysisRegion **ppAbortedRegion
);
Parameter
-
ppAbortedRegion [out]
-
Penunjuk ke IAnalysisRegion yang mewakili wilayah kotor (lihat Metode IInkAnalyzer::GetDirtyRegion) dari operasi analisis saat ini.
Menampilkan nilai
Untuk deskripsi nilai yang dikembalikan, lihat Kelas dan Antarmuka - Analisis Tinta.
Keterangan
Panggil IUnknown::Release di ppAbortedRegion saat Anda tidak perlu lagi menggunakan objek .
Metode ini membatalkan operasi analisis saat ini.
Ketika ppAbortedRegionADALAH NULL, metode ini melakukan pembatalakuan seperti biasa, karena ini menunjukkan bahwa penelepon tidak memiliki minat pada nilai yang dikembalikan.
IInkAnalyzer::Abort Method membungkam _IAnalysisEvents::Hasil dan _IAnalysisEvents::Peristiwa aktivitas untuk operasi analisis saat ini.
Metode IInkAnalyzer::Abort berjalan secara asinkron hingga operasi analisis latar belakang saat ini dibatalkan. Karena proses pembatalan tidak sinkron, aplikasi dapat melakukan tugas lain saat operasi analisis saat ini dibatalkan.
Jika tidak ada operasi analisis yang sedang berlangsung, metode ini mengembalikan wilayah analisis kosong.
Jika satu operasi analisis sedang berlangsung, metode ini membatalkan operasi.
Jika operasi analisis sinkron dan asinkron sedang berlangsung, metode ini membatalkan operasi sinkron.
Jika metode ini dipanggil lebih dari sekali untuk operasi analisis yang sama, panggilan pertama mengembalikan wilayah kotor untuk operasi, dan panggilan berikutnya mengembalikan wilayah kosong.
Jika aplikasi Anda mempertahankan struktur datanya sendiri yang disinkronkan dengan IInkAnalyzer, memanggil Metode IInkAnalyzer::Abort dapat meninggalkan dokumen Anda dengan hasil parsial. Untuk menghindari hal ini, jangan panggil IInkAnalyzer::Abort Method antara waktu IInkAnalyzer menerima peristiwa _IAnalysisProxyEvents::InkAnalyzerStateChanging dan waktu IInkAnalyzer menerima peristiwa _IAnalysisEvents::IntermediateResults atau _IAnalysisEvents::Results .
Untuk informasi selengkapnya tentang menyinkronkan data aplikasi Anda dengan penganalisis tinta, lihat Proksi Data dengan Analisis Tinta.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows XP Tablet PC Edition [hanya aplikasi desktop] |
| Server minimum yang didukung |
Tidak ada yang didukung |
| Header |
|
| DLL |
|