Método IInkRecognitionResult::ModifyTopAlternate (msinkaut.h)

Artigo
08/25/2023

Altera a alternativa superior de um resultado de reconhecimento usando a alternativa especificada.

Sintaxe

HRESULT ModifyTopAlternate(
  [in] IInkRecognitionAlternate *Alternate
);

Parâmetros

[in] Alternate

O IInkRecognitionAlternate a ser usado para modificar a alternativa superior.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
TPC_E_NOT_RELEVANT	A rede não contém dados.
E_POINTER	Um parâmetro continha um ponteiro inválido.
E_INVALIDARG	A alternativa não corresponde ao intervalo conhecido ou não foi obtida dessa rede.
E_INK_EXCEPTION	Ocorreu uma exceção durante o processamento.
E_OUTOFMEMORY	Não é possível alocar memória para concluir a operação.

Comentários

Por padrão, a melhor cadeia de caracteres de resultado do resultado do reconhecimento corresponde à alternativa superior. No entanto, você pode usar esse método para especificar que alternativas diferentes da alternativa superior são usadas no resultado. Ao escolher uma alternativa diferente da alternativa superior, você está essencialmente escolhendo um caminho diferente por meio da rede de alternativas associadas aos resultados.

Para recuperar as alternativas que podem ser usadas para modificar o resultado do reconhecimento, chame o método AlternatesFromSelection .

Nota Uma chamada para o Método ModifyTopAlternate pode modificar as propriedades TopString e TopAlternate .

A alternativa usada na função pode ser uma palavra alternativa em uma frase inteira. Por exemplo, uma alternativa obtida usando AlternatesFromSelection (0, 5) para "Olá, Mundo" altera apenas a parte "Olá" da palavra deixando a parte "Mundo" intacta.

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
Biblioteca	InkObj.dll