IInkAnalyzer::Abort (método)
Cancela la operación de análisis actual.
Sintaxis
HRESULT Abort(
[out] IAnalysisRegion **ppAbortedRegion
);
Parámetros
-
ppAbortedRegion [out]
-
Puntero a un IAnalysisRegion que representa la región desfasada (vea IInkAnalyzer::GetDirtyRegion Method) de la operación de análisis actual.
Valor devuelto
Para obtener una descripción de los valores devueltos, vea Clases e interfaces : análisis de entrada de lápiz.
Observaciones
Llame a IUnknown::Release en ppAbortedRegion cuando ya no necesite usar el objeto .
Este método cancela la operación de análisis actual.
Cuando ppAbortedRegion es NULL, este método realiza la anulación como normal, ya que esto indica que el autor de la llamada no tiene ningún interés en el valor devuelto.
El método IInkAnalyzer::Abort silencia los eventos _IAnalysisEvents::Results y _IAnalysisEvents::Activity para la operación de análisis actual.
IInkAnalyzer::Abort (Método) se ejecuta de forma asincrónica hasta que se cancele la operación de análisis en segundo plano actual. Dado que el proceso de cancelación es asincrónico, la aplicación puede realizar otras tareas mientras se cancelan las operaciones de análisis actuales.
Si no hay operaciones de análisis en curso, este método devuelve una región de análisis vacía.
Si hay una operación de análisis en curso, este método cancela la operación.
Si las operaciones de análisis sincrónicas y asincrónicas están en curso, este método cancela la operación sincrónica.
Si se llama a este método más de una vez para la misma operación de análisis, la primera llamada devuelve la región desfasada de la operación y las llamadas posteriores devuelven una región vacía.
Si la aplicación mantiene su propia estructura de datos que se sincroniza con la de IInkAnalyzer, llamar al método IInkAnalyzer::Abort puede dejar el documento con resultados parciales. Para evitar esto, no llame al método IInkAnalyzer::Abort entre el momento en que IInkAnalyzer recibe el evento _IAnalysisProxyEvents::InkAnalyzerStateChanging y la hora en que IInkAnalyzer recibe el evento _IAnalysisEvents::IntermediateResults o _IAnalysisEvents::Results .
Para obtener más información sobre cómo sincronizar los datos de la aplicación con el analizador de entrada de lápiz, consulte Proxy de datos con análisis de entrada de lápiz.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP Tablet PC Edition [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
No se admite ninguno |
| Encabezado |
|
| Archivo DLL |
|