IAgentCharacterEx::SetLanguageID
[Microsoft Agent является нерекомендуемым начиная с Windows 7 и может быть недоступен в последующих версиях Windows.]
HRESULT SetLanguageID(
long langID // language ID setting of character
);
Задает идентификатор языка, заданный для символа.
- Возвращает S_OK, указывающее, что операция была успешной.
-
langID
-
Параметр идентификатора языка для символа.
Длинное целое число, указывающее идентификатор языка для символа. Идентификатор языка (LANGID) для символа — это 16-битовое значение, определенное Windows, состоящее из идентификатора основного языка и идентификатора дополнительного языка. Для указанных языков можно использовать следующие значения. Дополнительные сведения см. в документации по пакету SDK для платформы.
| Язык | ID | Язык | ID |
|---|---|---|---|
| Арабский (Саудовская Аравия) | 0x0401 | Итальянский | 0x0410 |
| Баскский | 0x042d | Японский | 0x0411 |
| Китайский (упрощенное письмо) | 0x0804 | Корейский | 0x0412 |
| Китайский (традиционное письмо) | 0x0404 | Норвежский | 0x0414 |
| Хорватский | 0x041A | Польский | 0x0415 |
| Чешский | 0x0405 | Португальский (Португалия) | 0x0816 |
| Датский | 0x0406 | Португальский (Бразилия) | 0x0416 |
| Нидерландский | 0x0413 | Румынский | 0x0418 |
| Английский (Великобритания) | 0x0809 | Русский | 0x0419 |
| Английский (США) | 0x0409 | Словацкий | 0x041B |
| Финский | 0x040B | Словенский | 0x0424 |
| Французский | 0x040C | Испанский | 0x0C0A |
| Немецкий | 0x0407 | Шведский | 0x041D |
| Греческий | 0x0408 | Тайский | 0x041E |
| Иврит | 0x040D | Турецкий | 0x041F |
| Венгерский | 0x040E |
Если не задать идентификатор языка для символа, его идентификатором будет текущий системный идентификатор языка, если установлена соответствующая библиотека DLL языка агента; В противном случае языком символа будет английский (США).
Это свойство также определяет язык для слова выноски текста, команды во всплывающем меню символа и механизм распознавания речи. Он также определяет язык по умолчанию для выходных данных TTS. Чтобы определить, доступен ли совместимый речевой механизм для языка символа, используйте IAgentCharacterEx::GetSRModeID или IAgentCharacterEx::GetTTSModeID.
При попытке задать идентификатор языка для символа и языковых ресурсов агента, кодовой страницы или отображаемого шрифта для идентификатора языка недоступен, агент возвращает ошибку, а идентификатор языка символа остается в последнем параметре. Установка этого свойства не возвращает ошибку, если для языка нет подходящих речевых модулей.
Это свойство применяется только к использованию символа в клиентском приложении; Параметр не влияет на другие клиенты символа или другие символы клиентского приложения.
Примечание
Если для идентификатора языка символа задан язык, поддерживающий двунаправленный текст (например, арабский или иврит), но в системе, на котором выполняется приложение, не установлена двунаправленная поддержка, текст будет отображаться на выноске слова в логическом порядке, а не в порядке отображения.
См. также:
IAgentCharacterEx:GetLanguageID, IAgentCharacterEx::GetSRModeID, IAgentCharacterEx::GetTTSModeID