Поделиться через

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

  • Статья

Извлекает коллекцию, соответствующую наименьшему набору сегментов распознавания, который содержит указанный диапазон символов в альтернативном.

Синтаксис

HRESULT GetStrokesFromTextRange(
  [in, out]     long        *selectionStart,
  [in, out]     long        *selectionLength,
  [out, retval] IInkStrokes **GetStrokesFromTextRange
);

Параметры

[in, out] selectionStart

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

[in, out] selectionLength

Длина диапазона символов в альтернативном. Этот параметр должен быть больше 0. Этот параметр корректируется в соответствии с длиной наименьшего набора из одного или нескольких сегментов, включая выбор входных данных.

[out, retval] GetStrokesFromTextRange

При возврате содержит указатель на коллекцию штрихов, соответствующую известному диапазону распознанного текста.

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

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

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

Комментарии

Чтобы дополнительно прояснить GetStrokesFromTextRange, рассмотрим коллекцию штрихов, которые были распознаны и для которых лучшим вариантом для этих штрихов является "как вы". Параметр, передаваемый методу, представляет собой определенный диапазон в (или, возможно, весь) результат этой строки. Этот вариант содержит пять сегментов: по одному для каждого слова и по одному для каждого пробела. Возвращаемые штрихи соответствуют наименьшим наборам сегментов, включающих весь диапазон входных данных. Если параметр selectionStart равен 0, а параметр selectionLength равен 5, создается диапазон, соответствующий значению "how a" строки результата, то возвращаемые штрихи являются распознаваемыми штрихами, составляющими сегменты "how are". Это наименьший набор сегментов, включающий диапазон входных данных.

В распознавателях на основе слов и символов пробелы считаются символами. Если входной выбор соответствует символу пробела, этот метод возвращает и пустую коллекцию InkStrokes .

Требования

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

См. также раздел

Метод GetStrokesFromStrokeRanges

Метод GetTextRangeFromStrokes

Альтернативный интерфейс IInkRecognition

Коллекция InkStrokes