Metodo IInkAnalyzer::Analysis

Esegue l'analisi penna sincrona.

Sintassi

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

Parametri

ppStatus [out]

Puntatore a un oggetto IAnalysisStatus che descrive lo stato dell'operazione di analisi.

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce - Analisi input penna.

Commenti

Attenzione

Per evitare una perdita di memoria, chiamare IUnknown::Release in ppStatus quando non è più necessario usare lo stato di analisi.

Questo metodo avvia un'operazione di analisi penna sincrona. L'analisi dell'input penna include l'analisi del layout, la scrittura e la classificazione dei disegni e il riconoscimento della grafia. Questo metodo restituisce dopo il completamento dell'operazione di analisi.

Questo metodo restituisce E_POINTER se ppStatus è NULL.

Durante una chiamata al metodo IInkAnalyzer::Analizza metodo o IInkAnalyzer::BackgroundAnalyze, IInkAnalyzer analizza l'input penna all'interno della relativa area sporca (vedere Metodo IInkAnalyzer::GetDirtyRegion). Tuttavia, IInkAnalyzer può espandere l'operazione di analisi per includere aree adiacenti.

Questo metodo imposta l'area sporca dell'oggetto IInkAnalyzer su un'area vuota. Se un altro thread ha aggiunto i dati del tratto che non sono stati analizzati, IInkAnalyzer aggiunge il rettangolo di selezione dei tratti non elaborati alla relativa area sporca durante la fase di riconciliazione dell'analisi.

Questo metodo restituisce un errore se l'applicazione non gestisce l'evento _IAnalysisEvents::UpdateStrokesCache .

IInkAnalyzer non genera gli eventi _IAnalysisEvents::Results e _IAnalysisEvents::IntermediateResults in risposta a questo metodo.

Per modificare la modalità di esecuzione dell'analisi dell'input penna, usare il metodo IInkAnalyzer::SetAnalysisModes.

Per altre informazioni sull'analisi dell'input penna, vedere Panoramica dell'analisi dell'input penna.

Esempio

Nell'esempio seguente viene eseguita l'analisi dell'input penna in primo piano.

// 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;
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Intestazione	IACom.h (richiede anche IACom_i.c)
DLL	IACom.dll

Vedi anche

IInkAnalyzer

Analysismodes

Metodo IInkAnalyzer::GetDirtyRegion

Metodo IInkAnalyzer::SetDirtyRegion

Metodo IInkAnalyzer::GetRootNode

Metodo IInkAnalyzer::BackgroundAnalyze