Метод IInkLineInfo::SetCandidate (msinkaut.h)

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

Синтаксис

HRESULT SetCandidate(
  [in] UINT   nCandidateNum,
  [in] LPWSTR strRecogWord
);

Параметры

[in] nCandidateNum

Отсчитываемый от нуля индекс альтернативной записи списка для задания.

[in] strRecogWord

Указатель на новый замещающий текст.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_FAIL	Индекс nCandidateNum выходит за пределы диапазона.
E_OUTOFMEMORY	Не удалось завершить операцию. Список результатов распознавания не изменяется.

Комментарии

Список кандидатов может быть расширен только на одну новую запись за раз в конце текущего списка. Например, если объект текстового рукописного ввода (tInk) в настоящее время имеет десять результатов распознавания, то при задании для параметра nCandidateNum значения 10 добавляется новый результат в список результатов распознавания объекта рукописного ввода текста.

Требования

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

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

Метод GetCandidate

IInkLineInfo