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

Artículo
03/08/2023

Recupera una colección IInkRecognitionAlternates , que es una división del objeto IInkRecognitionAlternate en el que se llama a este método.

Sintaxis

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

Parámetros

[in] PropertyType

Especifica un valor de cadena que identifica la propiedad . Para obtener una lista de las propiedades que se pueden usar, consulte RecognitionProperty.

Para obtener más información sobre el tipo de datos BSTR, vea Uso de la biblioteca COM.

[out, retval] AlternatesWithConstantPropertyValues

Cuando este método devuelve , contiene una colección IInkRecognitionAlternates que se compone de una división de la alternativa en la que se llama a este método. Cada objeto IInkRecognitionAlternate de la colección contiene segmentos de reconocimiento adyacentes que tienen el mismo valor de propiedad para el parámetro propertyType .

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	Un parámetro contenía un puntero no válido.
E_INVALIDARG	El intervalo de reconocimiento no es válido.
E_INK_EXCEPTION	Se produjo una excepción durante el procesamiento.
E_OUTOFMEMORY	No se puede asignar memoria para completar la operación.

Comentarios

Cada alternativa de la colección contiene segmentos de reconocimiento adyacentes que tienen el mismo valor de propiedad para la propiedad pasada al método .

Por ejemplo, puede devolver alternativas que dividan la alternativa original por:

Nivel de confianza límites fuertes, intermedios o deficientes en el resultado del reconocimiento.
Límites de línea.
Límites del segmento de reconocimiento.

Para obtener una lista completa de los tipos de propiedad, vea RecognitionProperty.

Nota El reconocedor determina la segmentación de trazos en los segmentos de reconocimiento. Algunos segmentos de reconocimiento, como espacios, pueden corresponder a una colección InkStrokes vacía.

Nota El reconocedor determina el orden de los segmentos de reconocimiento. Por lo tanto, los segmentos de reconocimiento adyacentes pueden basarse en el orden en que se dibujó la entrada de lápiz o en función de la ubicación, como si se coloca de izquierda a derecha, posición superior a inferior, etc.

La propiedad ConfidenceAlternates es una alternativa al método AlternatesWithConstantPropertyValues , donde ConfidenceLevel es recognitionProperty que separa las alternativas de la colección de alternativas de reconocimiento devueltas.

La propiedad LineAlternates es una alternativa al método AlternatesWithConstantPropertyValues , donde LineNumber es recognitionProperty que separa las alternativas de la colección de alternativas de reconocimiento devueltas.

Nota El método AlternatesWithConstantPropertyValues , la propiedad LineAlternates y la propiedad ConfidenceAlternates de la función del objeto IInkRecognitionAlternate de forma diferente al método AlternatesFromSelection del objeto IInkRecognitionResult . AlternatesFromSelection devuelve una colección de alternativas para los segmentos solicitados del resultado de reconocimiento.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	msinkaut.h
Library	InkObj.dll