Interface IInkRecognitionResult (msinkaut.h)

Artigo
08/25/2023

Representa o resultado do reconhecimento. Os resultados do reconhecimento da tinta manuscrita são retornados em um objeto IInkRecognitionResult .

Herança

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

Métodos

A interface IInkRecognitionResult tem esses métodos.


IInkRecognitionResult::get_Strokes Obtém a coleção de traços contidos em um objeto ou usados para criar um objeto . (IInkRecognitionResult.get_Strokes)
IInkRecognitionResult::get_TopAlternate Obtém a melhor alternativa do resultado do reconhecimento. (IInkRecognitionResult.get_TopAlternate)
IInkRecognitionResult::get_TopConfidence Obtém a melhor alternativa do resultado do reconhecimento. (IInkRecognitionResult.get_TopConfidence)
IInkRecognitionResult::get_TopString Obtém o texto do resultado da propriedade TopAlternate.
IInkRecognitionResult::ModifyTopAlternate Altera a alternativa superior de um resultado de reconhecimento usando a alternativa especificada.
IInkRecognitionResult::SetResultOnStrokes Atribui os resultados de reconhecimento aos traços que foram usados para criar os resultados.

Comentários

Objetos IInkRecognitionAlternate , ou alternativos, são criados com base no resultado. O melhor ou superior alternativo é aquele usado pelo padrão no resultado. No entanto, você pode usar os métodos do objeto IInkRecognitionResult para especificar quais alternativas usar no resultado.

O desempenho do sistema poderá sofrer se os resultados do reconhecimento forem atribuídos automaticamente a cada coleção de traços. Portanto, por padrão, os resultados não são anexados a uma coleção de traços. Você deve chamar o método SetResultOnStrokes para atribuir resultados a uma coleção de traços.

A única maneira de persistir os resultados do reconhecimento é chamar SetResultOnStrokes e, em seguida, adicionar essa coleção de traços à coleção CustomStrokes no objeto InkDisp .

Nem todos os reconhecedores definem a propriedade TopConfidence . Quando um aplicativo tenta acessar uma propriedade que não é definida pelo reconhecedor, uma exceção de argumento é gerada.

Se você definir uma classe que implementa essa interface, a nova classe não interagirá corretamente com as APIs (interfaces de programação de aplicativo) do Tablet PC.

Nota Os vários reconhecedores de manuscrito enviados da Microsoft em caracteres latinos e idiomas do Leste Asiático às vezes podem produzir o valor Unicode 0xFFFF como resultado do reconhecimento. Isso ocorre quando o reconhecedor não consegue corresponder um pedaço de tinta com qualquer caractere válido. O ponto de código 0xFFFF é VÁLIDO UCS-2, mas não é permitido em UTF-8. Um aplicativo que converte resultados de reconhecimento em UTF-8 deve substituir 0xFFFF por algum outro ponto de código, por exemplo, 0xFFFD.

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
Plataforma de Destino	Windows
Cabeçalho	msinkaut.h