IInkAnalyzer::Analisis metode

Melakukan analisis tinta sinkron.

Sintaks

HRESULT Analyze(
  [out] IAnalysisStatus **ppStatus
);

Parameter

ppStatus [out]

Pointer ke IAnalysisStatus yang menjelaskan status operasi analisis.

Menampilkan nilai

Untuk deskripsi nilai yang dikembalikan, lihat Kelas dan Antarmuka - Analisis Tinta.

Keterangan

Perhatian

Untuk menghindari kebocoran memori, panggil IUnknown::Release di ppStatus ketika Anda tidak perlu lagi menggunakan status analisis.

Metode ini memulai operasi analisis tinta sinkron. Analisis tinta mencakup analisis tata letak, klasifikasi penulisan dan gambar, dan pengenalan tulisan tangan. Metode ini kembali setelah operasi analisis selesai.

Metode ini mengembalikan E_POINTER jika ppStatus adalah NULL.

Selama panggilan ke IInkAnalyzer::Analyze Method atau IInkAnalyzer::BackgroundAnalyze Method, IInkAnalyzer menganalisis tinta dalam wilayah kotornya (lihat Metode IInkAnalyzer::GetDirtyRegion). Namun, IInkAnalyzer dapat memperluas operasi analisis untuk menyertakan wilayah tetangga.

Metode ini mengatur wilayah kotor objek IInkAnalyzer ke wilayah kosong. Jika utas lain telah menambahkan data stroke yang belum dianalisis, IInkAnalyzer menambahkan kotak pembatas dari stroke yang tidak dianalisa ke wilayah kotornya selama fase rekonsiliasi analisis.

Metode ini mengembalikan kesalahan jika aplikasi Anda tidak menangani peristiwa _IAnalysisEvents::UpdateStrokesCache .

IInkAnalyzer tidak menaikkan peristiwa _IAnalysisEvents::Results dan _IAnalysisEvents::IntermediateResults sebagai respons terhadap metode ini.

Untuk mengubah cara analisis tinta dilakukan, gunakan Metode IInkAnalyzer::SetAnalysisModes.

Untuk informasi selengkapnya tentang analisis tinta, lihat Gambaran Umum Analisis Tinta.

Contoh

Contoh berikut melakukan analisis tinta latar depan.

// Perform synchronous ink analysis.
IAnalysisStatus *pAnalysisStatus = NULL;
hr = this->m_spIInkAnalyzer->Analyze(&pAnalysisStatus);

if (SUCCEEDED(hr))
{
    // Insert code that processes the analysis results.
}

// Release this reference to the analysis status.
if (pAnalysisStatus != NULL)
{
    pAnalysisStatus->Release();
    pAnalysisStatus = NULL;
}

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

AnalysisModes

Metode IInkAnalyzer::GetDirtyRegion

Metode IInkAnalyzer::SetDirtyRegion

Metode IInkAnalyzer::GetRootNode

IInkAnalyzer::Metode BackgroundAnalyze