Método IInkAnalyzer::Analyze

Realiza análisis de tinta sincrónica.

Sintaxis

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

Parámetros

ppStatus [out]

Puntero a un objeto IAnalysisStatus que describe el estado de la operación de análisis.

Valor devuelto

Para obtener una descripción de los valores devueltos, vea Clases e interfaces : análisis de entrada de lápiz.

Observaciones

Precaución

Para evitar una pérdida de memoria, llame a IUnknown::Release en ppStatus cuando ya no necesite usar el estado de análisis.

Este método inicia una operación de análisis de tinta sincrónica. El análisis de lápiz incluye análisis de diseño, escritura y clasificación de dibujo, y reconocimiento de escritura a mano. Este método devuelve una vez completada la operación de análisis.

Este método devuelve E_POINTER si ppStatus es NULL.

Durante una llamada a IInkAnalyzer::Analyze Method o IInkAnalyzer::BackgroundAnalyze Method, el IInkAnalyzer analiza la entrada de lápiz dentro de su región sucia (vea IInkAnalyzer::GetDirtyRegion Method). Sin embargo, IInkAnalyzer puede expandir la operación de análisis para incluir regiones vecinas.

Este método establece la región desfasada del objeto IInkAnalyzer en una región vacía. Si otro subproceso ha agregado datos de trazo que no se han analizado, IInkAnalyzer agrega el rectángulo delimitador de los trazos no sincronizados a su región sucia durante la fase de conciliación del análisis.

Este método devuelve un error si la aplicación no controla el evento _IAnalysisEvents::UpdateStrokesCache .

IInkAnalyzer no genera los eventos _IAnalysisEvents::Results y _IAnalysisEvents::IntermediateResults en respuesta a este método.

Para modificar la forma en que se realiza el análisis de entrada de lápiz, use IInkAnalyzer::SetAnalysisModes (Método).

Para obtener más información sobre el análisis de entrada de lápiz, consulte Información general sobre el análisis de lápiz.

Ejemplos

En el ejemplo siguiente se realiza el análisis de entrada de lápiz en primer plano.

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

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	IACom.h (también requiere IACom_i.c)
Archivo DLL	IACom.dll

Consulte también

IInkAnalyzer

AnalysisModes

IInkAnalyzer::GetDirtyRegion (Método)

IInkAnalyzer::SetDirtyRegion (Método)

IInkAnalyzer::GetRootNode (Método)

IInkAnalyzer::BackgroundAnalyze (Método)