Compartilhar via


Classe InkRecognizerContext

Permite a capacidade de executar o reconhecimento de tinta, recuperar o resultado do reconhecimento e recuperar alternativas. O InkRecognizerContext permite que os vários reconhecedores instalados em um sistema usem o reconhecimento de tinta para processar a entrada adequadamente.

InkRecognizerContext tem estes tipos de membros:

Eventos

A classe InkRecognizerContext tem esses eventos.

Evento Descrição
Reconhecimento Ocorre quando o InkRecognizerContext gera resultados do método BackgroundRecognize.
RecognitionWithAlternates Ocorre quando o InkRecognizerContext gera resultados depois de chamar o método BackgroundRecognizeWithAlternates

Interfaces

A classe InkRecognizerContext define essas interfaces.

Interface Descrição
Iinkrecognizercontext Esse objeto implementa a interface COM IInkRecognizerContext .

Métodos

A classe InkRecognizerContext tem esses métodos.

Método Descrição
BackgroundRecognize Especifica que o reconhecedor deve reconhecer os traços associados e disparar um evento de Reconhecimento quando o reconhecimento for concluído.
BackgroundRecognizeWithAlternates Especifica que o reconhecedor deve reconhecer os traços associados e disparar um evento RecognitionWithAlternates quando o reconhecimento for concluído.
Clone Cria um InkRecognizerContext duplicado.
EndInkInput Encerra a entrada de tinta para o InkRecognizerContext.
IsStringSupported Indica se o dicionário do sistema, o dicionário do usuário ou a lista de palavras contêm uma cadeia de caracteres especificada.
Recognize Executa o reconhecimento em uma coleção InkStrokes e retorna resultados de reconhecimento.
StopBackgroundRecognition Encerra o reconhecimento em segundo plano que foi iniciado com uma chamada para BackgroundRecognize ou BackgroundRecognizeWithAlternates.

Propriedades

A classe InkRecognizerContext tem essas propriedades.

Propriedade Tipo de acesso Descrição
CharacterAutoCompletion
Leitura/gravação
Obtém ou define o modo de preenchimento automático de caracteres, que determina quando caracteres ou palavras são reconhecidos.
Factoid
Leitura/gravação
Obtém ou define o nome da cadeia de caracteres do factoid usado pelo objeto InkRecognizerContext .
Guia
Leitura/gravação
Obtém ou define o InkRecognizerGuide a ser usado para entrada à tinta.
PrefixText
Leitura/gravação
Obtém ou define os caracteres que vêm antes da coleção InkStrokes no objeto InkRecognizerContext .
RecognitionFlags
Leitura/gravação
Obtém ou define os sinalizadores que especificam como o reconhecedor interpreta a tinta e determina a cadeia de caracteres de resultado.
Reconhecedor
Leitura/gravação
Obtém ou define o objeto IInkRecognizer usado pelo objeto InkRecognizerContext .
Traços
Leitura/gravação
Obtém ou define a coleção InkStrokes associada ao objeto InkRecognizerContext .
SuffixText
Leitura/gravação
Obtém ou define os caracteres que vêm após a coleção InkStrokes no objeto InkRecognizerContext .
Wordlist
Leitura/gravação
Obtém ou define o objeto InkWordList usado para melhorar os resultados do reconhecimento.

Comentários

Esse objeto pode ser instanciado chamando o método CoCreateInstance em C++.

Há dois tipos de reconhecimento: plano de fundo (assíncrono) ou primeiro plano (síncrono). O reconhecimento em segundo plano é iniciado por uma chamada para os métodos BackgroundRecognize ou BackgroundRecognizeWithAlternates , ocorre em um thread em segundo plano e relata os resultados para o aplicativo por meio de um mecanismo de evento. O reconhecimento em primeiro plano não retorna até que todo o reconhecimento seja concluído, disponibilizando os resultados do reconhecimento para o thread de chamada sem escutar o evento de reconhecimento.

A tinta é processada continuamente em segundo plano. Se um IInkStrokeDisp for adicionado à coleção InkStrokes à qual o InkRecognizerContext se refere, o IInkStrokeDisp será reconhecido imediatamente. Consulte os comentários no tópico do método EndInkInput para obter mais detalhes.

Todo o reconhecimento ocorre por meio de um contexto de reconhecedor. O contexto define as configurações para uma única sessão de reconhecimento. Ele recebe a tinta que deve ser reconhecida e define as restrições na entrada de tinta e na saída de reconhecimento. As restrições que podem ser definidas no contexto incluem o idioma, o dicionário e a gramática que está sendo usado.

Observação

Definir propriedades diferentes das propriedades Strokes ou CharacterAutoCompletion terá êxito somente se a coleção InkStrokes for NULL. Você deve definir as outras propriedades antes de anexar a coleção InkStrokes ao InkRecognizerContext ou definir a coleção InkStrokes como NULL e definir as outras propriedades. Se você definir a coleção InkStrokes como NULL e definir as outras propriedades, talvez seja necessário reanexar a coleção InkStrokes. Isso ocorre porque o reconhecimento é iniciado logo após você atribuir InkStrokes ao InkRecognizerContext. Quando uma chamada é feita para o Método Recognize [Classe InkRecognizeContext] ou BackgroundRecognize, os resultados da chamada já podem estar disponíveis.

Para melhorar o desempenho do aplicativo, descarte o objeto InkRecognizerContext quando ele não for mais necessário.

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
Msinkaut.h (também requer Msinkaut_i.c)
Biblioteca
InkObj.dll

Confira também

IInkRecognizer Interface

Coleção InkStrokes