Metodo IInkAnalyzer::Abort
Annulla l'operazione di analisi corrente.
Sintassi
HRESULT Abort(
[out] IAnalysisRegion **ppAbortedRegion
);
Parametri
-
ppAbortedRegion [out]
-
Puntatore a un oggetto IAnalysisRegion che rappresenta l'area dirty (vedere IInkAnalyzer::GetDirtyRegion Metodo) dell'operazione di analisi corrente.
Valore restituito
Per una descrizione dei valori restituiti, vedere Classi e interfacce - Analisi input penna.
Commenti
Chiamare IUnknown::Release in ppAbortedRegion quando non è più necessario usare l'oggetto.
Questo metodo annulla l'operazione di analisi corrente.
Quando ppAbortedRegion è NULL, questo metodo esegue l'interruzione come normale, perché indica che il chiamante non ha alcun interesse nel valore restituito.
Il metodo IInkAnalyzer::Abort silenzio gli eventi _IAnalysisEvents::Risultati e _IAnalysisEvents::Activity per l'operazione di analisi corrente.
Il metodo IInkAnalyzer::Abort viene eseguito in modo asincrono finché l'operazione di analisi in background corrente non viene annullata. Poiché il processo di annullamento è asincrono, l'applicazione può eseguire altre attività mentre le operzioni di analisi correnti vengono annullate.
Se non sono in corso operazioni di analisi, questo metodo restituisce un'area di analisi vuota.
Se un'operazione di analisi è in corso, questo metodo annulla l'operazione.
Se entrambe le operazioni di analisi sincrone e asincrone sono in corso, questo metodo annulla l'operazione sincrona.
Se questo metodo viene chiamato più volte per la stessa operazione di analisi, la prima chiamata restituisce l'area sporca per l'operazione e le chiamate successive restituiscono un'area vuota.
Se l'applicazione gestisce la propria struttura di dati sincronizzata con quella di IInkAnalyzer, la chiamata a IInkAnalyzer::Abort Method può lasciare il documento con risultati parziali. Per evitare questo problema, non chiamare il metodo IInkAnalyzer::Abort tra l'ora in cui IInkAnalyzer riceve l'evento _IAnalysisProxyEvents::InkAnalyzerStateChanging e l'ora in cui IInkAnalyzer riceve l'evento _IAnalysisEvents:: IntermediateResults o _IAnalysisEvents :: Results .
Per altre informazioni sulla sincronizzazione dei dati dell'applicazione con l'analizzatore input penna, vedere Proxy dati con Analisi input penna.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP Tablet PC Edition [solo app desktop] |
| Server minimo supportato |
Nessuno supportato |
| Intestazione |
|
| DLL |
|