Метод IInkRecognitionAlternate::AlternatesWithConstantPropertyValues (msinkaut.h)

Статья
03/13/2024

Извлекает коллекцию IInkRecognitionAlternates , которая является подразделением объекта IInkRecognitionAlternate , для которого вызывается этот метод.

Синтаксис

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

Параметры

[in] PropertyType

Задает строковое значение, идентифицирующее свойство . Список свойств, которые можно использовать, см. в разделе RecognitionProperty.

Дополнительные сведения о типе данных BSTR см. в разделе Использование библиотеки COM.

[out, retval] AlternatesWithConstantPropertyValues

При возврате этого метода содержит коллекцию IInkRecognitionAlternates , которая состоит из деления альтернативного метода, для которого вызывается этот метод. Каждый объект IInkRecognitionAlternate в коллекции содержит смежные сегменты распознавания, имеющие одинаковое значение свойства для параметра propertyType .

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Успешно.
E_POINTER	Параметр содержал недопустимый указатель.
E_INVALIDARG	Недопустимый диапазон распознавания.
E_INK_EXCEPTION	Во время обработки произошло исключение.
E_OUTOFMEMORY	Не удается выделить память для завершения операции.

Каждый альтернативный вариант в коллекции содержит смежные сегменты распознавания, которые имеют одинаковое значение свойства для свойства, переданного в метод .

Например, можно вернуть альтернативные варианты, разделяющие исходный вариант на:

Уровень достоверности границ — сильный, промежуточный или плохой в результате распознавания.
Границы линий.
Границы сегмента распознавания.

Полный список типов свойств см. в разделе RecognitionProperty.

Примечание Распознаватель определяет сегментацию штрихов на сегменты распознавания. Некоторые сегменты распознавания, например пробелы, могут соответствовать пустой коллекции InkStrokes .

Примечание Распознаватель определяет порядок сегментов распознавания. Таким образом, смежные сегменты распознавания могут основываться на порядке, в котором был нарисован рукописный фрагмент, или по расположению, например слева направо, сверху вниз и т. д.

Свойство ConfidenceAlternates является альтернативой методу AlternatesWithConstantPropertyValues , где ConfidenceLevel — это Свойство RecognitionProperty, которое разделяет альтернативные варианты в возвращаемой коллекции альтернативных вариантов распознавания.

Свойство LineAlternates является альтернативой методу AlternatesWithConstantPropertyValues , где LineNumber — это Свойство RecognitionProperty, которое разделяет альтернативные варианты в возвращаемой коллекции альтернативных вариантов распознавания.

Примечание Метод AlternatesWithConstantPropertyValues , свойство LineAlternates и confidenceAlternates объекта IInkRecognitionAlternate работают иначе, чем метод AlternatesFromSelection объекта IInkRecognitionResult . AlternatesFromSelection возвращает коллекцию вариантов для запрошенных сегментов результата распознавания.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	msinkaut.h
Библиотека	InkObj.dll