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 |
|
| Archivo DLL |
|