Método IInkRecognitionAlternate::AlternatesWithConstantPropertyValues (msinkaut.h)

Artigo
08/25/2023

Recupera uma coleção IInkRecognitionAlternates , que são uma divisão do objeto IInkRecognitionAlternate no qual esse método é chamado.

Sintaxe

HRESULT AlternatesWithConstantPropertyValues(
  [in]          BSTR                      PropertyType,
  [out, retval] IInkRecognitionAlternates **AlternatesWithConstantPropertyValues
);

Parâmetros

[in] PropertyType

Especifica um valor de cadeia de caracteres que identifica a propriedade . Para obter uma lista das propriedades que podem ser usadas, consulte RecognitionProperty.

Para obter mais informações sobre o tipo de dados BSTR, consulte Usando a biblioteca COM.

[out, retval] AlternatesWithConstantPropertyValues

Quando esse método retorna, contém uma coleção IInkRecognitionAlternates que é composta por uma divisão da alternativa na qual esse método é chamado. Cada objeto IInkRecognitionAlternate na coleção contém segmentos de reconhecimento adjacentes que têm o mesmo valor de propriedade para o parâmetro propertyType .

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
E_POINTER	Um parâmetro continha um ponteiro inválido.
E_INVALIDARG	O intervalo de reconhecimento é inválido.
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

Cada alternativa na coleção contém segmentos de reconhecimento adjacentes que têm o mesmo valor de propriedade para a propriedade passada para o método .

Por exemplo, você pode retornar alternativas que dividem a alternativa original por:

Nível de limites de confiança forte, intermediário ou insatisfatório no resultado do reconhecimento.
Limites de linha.
Limites do segmento de reconhecimento.

Para obter uma lista completa de tipos de propriedade, consulte RecognitionProperty.

Nota O reconhecedor determina a segmentação de traços nos segmentos de reconhecimento. Alguns segmentos de reconhecimento, como espaços, podem corresponder a uma coleção InkStrokes vazia.

Nota O reconhecedor determina a ordenação dos segmentos de reconhecimento. Portanto, segmentos de reconhecimento adjacentes podem ser baseados na ordem em que a tinta foi desenhada ou com base na localização, como se ela está posicionada da esquerda para a direita, posicionada de cima para baixo e assim por diante.

A propriedade ConfidenceAlternates é uma alternativa ao método AlternatesWithConstantPropertyValues , em que ConfidenceLevel é o RecognitionProperty que separa as alternativas na coleção de alternativas de reconhecimento retornada.

A propriedade LineAlternates é uma alternativa ao método AlternatesWithConstantPropertyValues , em que LineNumber é o RecognitionProperty que separa as alternativas na coleção de alternativas de reconhecimento retornada.

Nota O método AlternatesWithConstantPropertyValues , a propriedade LineAlternates e a propriedade ConfidenceAlternates do objeto IInkRecognitionAlternate funcionam de forma diferente do método AlternatesFromSelection do objeto IInkRecognitionResult . AlternatesFromSelection retorna uma coleção de alternativas para os segmentos solicitados do resultado do reconhecimento.

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