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 |
|
| Biblioteca |
|