IAgentCharacterEx::SetLanguageID

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows].

HRESULT SetLanguageID(
   long langID  // language ID setting of character
); 

Establece el identificador de idioma establecido para el carácter.

• Devuelve S_OK para indicar que la operación se realizó correctamente.

langID

Configuración del identificador de idioma para el carácter.

Entero long que especifica el identificador de idioma para el carácter. El identificador de idioma (LANGID) de un carácter es un valor de 16 bits definido por Windows, que consta de un identificador de idioma principal y un identificador de idioma secundario. Puede usar los valores siguientes para los idiomas especificados. Para más información, consulte la documentación del SDK de plataforma.

Lenguaje	ID	Lenguaje	ID
Árabe (Saudí)	0x0401	Italiano	0x0410
Vasco	0x042d	Japonés	0x0411
Chino (simplificado)	0x0804	Coreano	0x0412
Chino (tradicional)	0x0404	Noruego	0x0414
Croata	0x041A	Polaco	0x0415
Checo	0x0405	Portugués (Portugal)	0x0816
Danés	0x0406	Portugués (Brasil)	0x0416
Neerlandés	0x0413	Rumano	0x0418
Inglés (Gran Bretaña)	0x0809	Ruso	0x0419
Inglés (EE.UU.)	0x0409	Eslovaco	0x041B
Finés	0x040B	Esloveno	0x0424
Francés	0x040C	Español	0x0C0A
Alemán	0x0407	Sueco	0x041D
Griego	0x0408	Tailandés	0x041E
Hebreo	0x040D	Turco	0x041F
Húngaro	0x040E

 

Si no establece el identificador de idioma para el carácter, su identificador de idioma será el identificador de idioma del sistema actual si está instalado el archivo DLL de idioma del agente correspondiente; de lo contrario, el idioma del carácter será inglés (EE. UU.).

Esta propiedad también determina el idioma del texto del globo de palabras, los comandos del menú emergente del carácter y el motor de reconocimiento de voz. También determina el idioma predeterminado para la salida de TTS. Para determinar si hay un motor de voz compatible disponible para el lenguaje del carácter, use IAgentCharacterEx::GetSRModeID o IAgentCharacterEx::GetTTSModeID.

Si intenta establecer el identificador de idioma de un carácter y los recursos de idioma del agente, la página de códigos o una fuente para mostrar para el identificador de idioma no está disponible, el Agente devuelve un error y el identificador de idioma del carácter permanece en su última configuración. Al establecer esta propiedad no se devuelve un error si no hay motores de voz coincidentes para el idioma.

Esta propiedad solo se aplica al uso del carácter de la aplicación cliente; la configuración no afecta a otros clientes del carácter u otros caracteres de la aplicación cliente.

Nota

Si establece el identificador de idioma del carácter en un idioma que admita texto bidireccional (como árabe o hebreo), pero el sistema que ejecuta la aplicación no tiene instalada compatibilidad bidireccional, el texto aparecerá en el globo de palabras en orden lógico en lugar de mostrar.

 

Consulte también

IAgentCharacterEx:GetLanguageID, IAgentCharacterEx::GetSRModeID, IAgentCharacterEx::GetTTSModeID