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	IACom.h (juga memerlukan IACom_i.c)
DLL	IACom.dll

Lihat juga

IInkAnalyzer

IInkAnalyzer::Analisis Metode

Metode IInkAnalyzer::BackgroundAnalyze

Metode IInkAnalyzer::GetDirtyRegion

Metode IInkAnalyzer::SetDirtyRegion

Referensi Analisis Tinta