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


Метод IInkRecognizers::GetDefaultRecognizer (msinkaut.h)

Извлекает распознаватель по умолчанию для известного языка, заданного идентификатором кода языка поддержки национального языка (NLS).

Синтаксис

HRESULT GetDefaultRecognizer(
  [in]          long           lcid,
  [out, retval] IInkRecognizer **DefaultRecognizer
);

Параметры

[in] lcid

Идентификатор языкового стандарта LCID языка, для которого вы извлеките распознаватель по умолчанию. Если lcid имеет значение 0, метод использует параметр языкового стандарта пользователя, чтобы определить, какой распознаватель по умолчанию следует извлечь. Если пользователь не указал языковой стандарт в региональных параметрах, метод использует языковой стандарт, указанный для компьютера. Значение по умолчанию — 0.

[out, retval] DefaultRecognizer

При возврате этого метода содержит указатель на запрошенный распознаватель.

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

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

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

Комментарии

Каждый язык может иметь распознаватель по умолчанию. Например, у пользователя может быть распознаватель по умолчанию для английского языка США и распознаватель по умолчанию для французского языка. Если языковой стандарт не указан, этот метод возвращает распознаватель для активного входного языкового стандарта. Чтобы выбрать активный языковой стандарт ввода, в разделе Региональные и языковые параметры в ControlPanel на вкладке Языки пользователи нажимают кнопку Сведения, а затем выберите язык ввода по умолчанию.

Значение по умолчанию параметра lcid равно 0.

Этот метод создает ошибку, если параметр lcid не является известным языковым стандартом или если распознаватель не установлен для запрошенного языкового стандарта.

GetDefaultRecognizer сначала проверяет наличие соответствующего распознавателя для входного языкового стандарта пользователя. Если его нет, проверяется, есть ли соответствующий распознаватель для текущего языкового стандарта системы.

Дополнительные сведения о NLS см. в разделе Терминология NLS.

Требования

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

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

Интерфейс IInkRecognizer

IInkRecognizers

Коллекция InkRecognizers