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

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

  • Статья

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

Синтаксис

HRESULT GetCandidate(
  [in]  UINT   nCandidateNum,
  [out] LPWSTR pwcRecogWord,
  [out] UINT   *pcwcRecogWord,
  [in]  DWORD  dwFlags
);

Параметры

[in] nCandidateNum

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

[out] pwcRecogWord

Буфер, в котором будет храниться выбранный альтернативный вариант распознавания. Если pwcRecogWord имеет значение NULL, метод не пытается получить альтернативное слово распознавания.

[out] pcwcRecogWord

Передает длину буфера pwcRecogWord в символах Юникода и возвращает количество символов Юникода, скопированных в буфер.

[in] dwFlags

Не используется.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_FAIL
 Индекс nCandidateNum больше, чем число альтернативных вариантов распознавания.
ERROR_MORE_DATA
 Буфер pwcRecogWord недостаточно велик, чтобы принять альтернативный вариант распознавания.

Комментарии

Если параметр pwcRecogWord имеет значение NULL, метод не пытается получить альтернативное слово распознавания, а задает для pwcRecogWord число символов в альтернативном варианте распознавания.

Если буфер pwcRecogWord недостаточно велик, чтобы содержать альтернативный вариант распознавания, то буфер pwcRecogWord заполняется первым числом символов pwcRecogWord из альтернативного распознавания.

Требования

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

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

IInkLineInfo

Метод SetCandidate