Método IInkAnalyzer::Analyze
Executa a análise de tinta síncrona.
Sintaxe
HRESULT Analyze(
[out] IAnalysisStatus **ppStatus
);
Parâmetros
-
ppStatus [out]
-
Um ponteiro para um IAnalysisStatus que descreve o status da operação de análise.
Valor retornado
Para obter uma descrição dos valores retornados, consulte Classes e interfaces – Análise de tinta.
Comentários
Cuidado
Para evitar uma perda de memória, chame IUnknown::Release em ppStatus quando você não precisar mais usar a análise status.
Esse método inicia uma operação de análise de tinta síncrona. A análise de tinta inclui análise de layout, classificação de desenho e escrita e reconhecimento de manuscrito. Esse método retorna após a conclusão da operação de análise.
Esse método retornará E_POINTER se ppStatus for NULL.
Durante uma chamada ao Método IInkAnalyzer::Analyze ou ao Método IInkAnalyzer::BackgroundAnalyze, o IInkAnalyzer analisa a tinta em sua região de sujo (consulte Método IInkAnalyzer::GetDirtyRegion). No entanto, o IInkAnalyzer pode expandir a operação de análise para incluir regiões vizinhas.
Esse método define a região sujo do objeto IInkAnalyzer como uma região vazia. Se outro thread tiver adicionado dados de traço que não foram analisados, o IInkAnalyzer adicionará a caixa delimitadora dos traços não analisados à sua região sujo durante a fase de reconciliação da análise.
Esse método retornará um erro se o aplicativo não manipular o evento _IAnalysisEvents::UpdateStrokesCache .
O IInkAnalyzer não gera os eventos _IAnalysisEvents::Results e _IAnalysisEvents::IntermediateResults em resposta a esse método.
Para modificar a maneira como a análise de tinta é executada, use o Método IInkAnalyzer::SetAnalysisModes.
Para obter mais informações sobre a análise de tinta, consulte Visão geral da análise de tinta.
Exemplos
O exemplo a seguir executa a análise de tinta em primeiro 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 | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP Tablet PC Edition [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Nenhum compatível |
| Cabeçalho |
|
| DLL |
|