Interface IInkAnalyzer

Fornece acesso à análise de layout, à classificação de escrita e desenho e ao reconhecimento de manuscrito.

Membros

A interface IInkAnalyzer herda da interface IUnknown . IInkAnalyzer também tem estes tipos de membros:

• Métodos

Métodos

A interface IInkAnalyzer tem esses métodos.

Método	Descrição
Anular	Cancela a operação de análise atual.
AddStroke	Adiciona dados de traço para um único traço ao IInkAnalyzer e atribui o identificador de cultura do thread de entrada ativo ao traço.
AddStrokeForLanguage	Adiciona dados de traço para um único traço ao IInkAnalyzer e atribui um identificador de cultura específico ao traço.
AddStrokes	Adiciona dados de traço para vários traços ao IInkAnalyzer e atribui o identificador de cultura do thread de entrada ativo aos traços.
AddStrokesForLanguage	Adiciona dados de traço para vários traços ao IInkAnalyzer e atribui o identificador de cultura especificado aos traços.
AddStrokesToCustomRecognizer	Adiciona dados de traço para vários traços a um nó de reconhecedor personalizado.
AddStrokeToCustomRecognizer	Adiciona dados de traço para um único traço a um nó de reconhecedor personalizado.
Analisar	Executa a análise de tinta síncrona.
BackgroundAnalyze	Executa a análise de tinta assíncrona.
ClearStrokeData	Limpa os dados do pacote de traço do IInkAnalyzer.
CreateAnalysisHint	Adiciona um novo nó de dica de análise com uma área infinita ao IInkAnalyzer.
CreateContextNodes	Cria um objeto IContextNodes .
CreateCustomRecognizer	Cria um novo nó de reconhecedor personalizado para o IInkAnalyzer.
DeleteAnalysisHint	Remove uma dica de análise do IInkAnalyzer.
FindInkLeafNodes	Recupera todos os nós folha de tinta.
FindInkLeafNodesForStrokes	Recupera os nós folha de tinta que contêm os traços especificados.
FindLeafNodes	Recupera todos os nós folha.
Findnode	Recupera o objeto IContextNode para um GUID (identificador global exclusivo) especificado.
FindNodesOfType	Recupera todos os objetos IContextNode do tipo especificado.
FindNodesOfTypeForStrokes	Recupera todos os objetos IContextNode do tipo especificado que contêm os traços especificados.
FindNodesOfTypeInSubTree	Recupera todos os objetos IContextNode do tipo especificado descendentes do objeto IContextNode especificado.
FindNodesWithCallBack	Recupera todos os objetos IContextNode que correspondem aos critérios especificados.
FindNodesWithCallBackInSubTree	Recupera todos os objetos IContextNode que correspondem aos critérios especificados e são descendentes do objeto IContextNode especificado.
GetAlternates	Recupera 10 alternativas de análise para toda a tinta associada ao IInkAnalyzer.
GetAlternatesForContextNodes	Recupera alternativas de análise para os nós em uma coleção IContextNodes especificada.
GetAlternatesForStrokes	Recupera alternativas de análise para os traços com os identificadores de traço especificados.
GetAnalysisHints	Recupera todos os objetos IContextNode da dica de análise anexados ao IInkAnalyzer.
GetAnalysisHintsByName	Recupera todos os objetos IContextNode da dica de análise anexados ao IInkAnalyzer e que têm o nome especificado.
GetAnalysisModes	Recupera sinalizadores que controlam como o IInkAnalyzer executa a análise de tinta.
GetDirtyRegion	Recupera a área que foi alterada desde a última operação de análise.
GetInkAnalysisRecognizersByPriority	Recupera uma coleção ordenada de objetos IInkAnalysisRecognizer .
GetNodesFromTextRange	Recupera uma coleção de objetos IContextNode que são relevantes para o intervalo de texto especificado para os nós de contexto especificados.
GetRecognizedString	Recupera a cadeia de caracteres de melhor resultado da operação de reconhecimento para toda a árvore de nós de contexto no IInkAnalyzer.
GetRootNode	Recupera o IContextNode raiz da árvore de contexto do objeto IInkAnalyzer .
GetStrokeLanguageId	Recupera o identificador de localidade do traço especificado.
GetStrokeType	Recupera o tipo do traço especificado.
GetTextRangeFromNodes	Localiza o intervalo de texto na cadeia de caracteres reconhecida que corresponde a uma coleção de objetos IContextNode .
IsAnalyzing	Recupera um valor que indica se o IInkAnalyzer está executando a análise de tinta.
LoadResults	Carrega os resultados da análise salva no IInkAnalyzer.
ModifyTopAlternate	Altera a alternativa superior atual para a alternativa especificada e limpa o tipo de confirmação para todos os objetos IContextNode associados à alternativa.
ModifyTopAlternateWithConfirmation	Altera a alternativa superior atual para o IAnalysisAlternate especificado.
Reconcile	Determina quais partes dos resultados da análise foram alteradas durante a análise de tinta em segundo plano.
RemoveStroke	Remove o traço especificado do IInkAnalyzer.
RemoveStrokes	Remove os traços especificados do IInkAnalyzer.
SaveResults	Salva todos os resultados de análise para um IInkAnalyzer.
SaveResultsForNodes	Salva os resultados da análise para uma coleção de nós de contexto específica associada a um IInkAnalyzer.
SaveResultsForStrokes	Salva os resultados da análise para os traços especificados associados a um IInkAnalyzer.
Pesquisar	Fornece uma pesquisa baseada em frase difusa e sem diferenciação de maiúsculas e minúsculas para traços de escrita analisados e traços de desenho analisados que têm tipos reconhecidos.
SearchWithLanguageId	Fornece uma pesquisa baseada em frase difusa e sem diferenciação de maiúsculas e minúsculas para traços de escrita analisados e traços de desenho analisados que têm tipos reconhecidos.
SetAnalysisModes	Modifica sinalizadores que controlam como o IInkAnalyzer executa a análise de tinta.
SetDirtyRegion	Modifica a área que foi alterada desde a última operação de análise.
SetHighestPriorityInkAnalysisRecognizer	Move o IInkAnalysisRecognizer especificado para a primeira posição na lista de reconhecedores de tinta do objeto IInkAnalyzer .
SetStrokeLanguageId	Altera o identificador de localidade para o traço especificado.
SetStrokesLanguageId	Altera o identificador de localidade para os traços especificados.
SetStrokesType	Altera o tipo dos traços especificados.
SetStrokeType	Altera o tipo do traço especificado.
UpdateStrokesData	Atualizações os dados do pacote para os traços especificados.

Comentários

O IInkAnalyzer usa dados de pacote de traço para analisar a tinta e não interage diretamente com objetos da Classe InkDisp ou da Coleção InkStrokes .

Para adicionar ou remover traços ao IInkAnalyzer para análise, use um dos métodos a seguir.

• Método IInkAnalyzer::AddStroke
• Método IInkAnalyzer::AddStrokes
• Método IInkAnalyzer::RemoveStroke
• Método IInkAnalyzer::RemoveStrokes

Esses métodos atualizam a região sujo (consulte Método IInkAnalyzer::GetDirtyRegion), que é a região para a qual os traços são analisados na próxima operação de análise.

Para analisar a tinta, use o método IInkAnalyzer::Analyze ou Método IInkAnalyzer::BackgroundAnalyze . Durante a análise, o IInkAnalyzer executa análise de layout, classificação de traço e reconhecimento de manuscrito.

Para alterar as configurações de análise de layout e classificação de traço, use a propriedade Método IInkAnalyzer::SetAnalysisModes .

Durante a análise, o IInkAnalyzer recebe vários eventos, incluindo eventos gerados durante a análise em segundo plano. _IAnalysisProxyEvents dá suporte aos recursos de proxy de dados do IInkAnalyzer. Para obter mais informações, consulte Proxy de dados com Análise de Tinta. Para interromper o processo de análise de dentro de um manipulador de eventos, chame o Método IInkAnalyzer::Abort.

Para modificar o idioma que o analisador de tinta usa para reconhecer a manuscrito, use o Método IInkAnalyzer::SetStrokeLanguageId ou Método IInkAnalyzer::SetStrokesLanguageId. Para modificar como o analisador de tinta classifica traços específicos, use o Método IInkAnalyzer::SetStrokeType ou o Método IInkAnalyzer::SetStrokesType.

O IInkAnalyzer carrega informações para todos os reconhecedores de tinta instalados. O método IInkAnalyzer::GetInkAnalysisRecognizersByPriority retorna uma coleção IInkAnalysisRecognizers que contém cada IInkAnalysisRecognizer disponível. Se mais de um reconhecedor de tinta der suporte a uma linguagem específica, use o Método IInkAnalyzer::SetHighestPriorityInkAnalysisRecognizer para definir qual reconhecedor de tinta manipula traços para esse idioma.

O uso de dicas de análise pode melhorar a precisão do reconhecimento fornecendo contexto extra ao analisador de tinta. As informações de contexto adicionais podem ajudar o analisador de tinta a limitar o número de resultados de reconhecimento possíveis. Por exemplo, você pode restringir o escopo definindo factóides e palavras esperadas ou estruturando sua entrada em um guia de reconhecimento. Para obter mais informações sobre como fornecer contexto ao analisador de tinta, consulte:

• Método IInkAnalyzer::CreateAnalysisHint
• Método IInkAnalyzer::D eleteAnalysisHint
• Método IInkAnalyzer::GetAnalysisHints
• Método IInkAnalyzer::GetAnalysisHintsByName

O analisador de tinta representa os resultados da análise como uma cadeia de caracteres ou como uma árvore de objetos IContextNode . Para acessar a cadeia de caracteres reconhecida, use o Método IInkAnalyzer::GetRecognizedString. Para acessar a raiz da árvore de nó de contexto, use o Método IInkAnalyzer::GetRootNode. O analisador de tinta tem os seguintes métodos para localizar nós de contexto ou texto específicos.

• Método IInkAnalyzer::FindInkLeafNodes
• Método IInkAnalyzer::FindInkLeafNodesForStrokes
• Método IInkAnalyzer::FindLeafNodes
• Método IInkAnalyzer::FindNode
• Método IInkAnalyzer::FindNodesOfType
• Método IInkAnalyzer::FindNodesOfTypeForStrokes
• Método IInkAnalyzer::FindNodesOfTypeInSubTree
• Método IInkAnalyzer::FindNodesWithCallBack
• Método IInkAnalyzer::FindNodesWithCallBackInSubTree

Para trabalhar com resultados de análise alternativos, use um dos métodos a seguir.

• Método IInkAnalyzer::GetAlternates
• Método IInkAnalyzer::GetAlternatesForContextNodes
• Método IInkAnalyzer::GetAlternatesForStrokes
• Método IInkAnalyzer::ModifyTopAlternate
• Método IInkAnalyzer::ModifyTopAlternateWithConfirmation

Para salvar os resultados da análise, use um dos métodos a seguir.

• Método IInkAnalyzer::SaveResults
• Método IInkAnalyzer::SaveResultsForNodes
• Método IInkAnalyzer::SaveResultsForStrokes

Para carregar os resultados salvos, use o Método IInkAnalyzer::LoadResults.

Para obter mais informações sobre como usar o IInkAnalyzer para analisar a tinta, consulte Visão geral da análise de tinta.

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	IACom.h (também requer IACom_i.c)
DLL	IACom.dll

Confira também

AnalysisModes

IAnalysisAlternate

IAnalysisStatus

IContextLink

IContextNode

Referência de análise de tinta