Partager via

IAgentCharacterEx::SetLanguageID

  • Article

[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible dans les versions ultérieures de Windows.]

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

Définit l’ID de langue défini pour le caractère.

  • Retourne S_OK pour indiquer que l’opération a réussi.

langID

Paramètre d’ID de langue pour le caractère.

Entier long spécifiant l’ID de langue du caractère. L’ID de langue (LANGID) d’un caractère est une valeur 16 bits définie par Windows, composée d’un ID de langue principale et d’un ID de langue secondaire. Vous pouvez utiliser les valeurs suivantes pour les langues spécifiées. Pour plus d’informations, consultez la documentation du Kit de développement logiciel (SDK) de plateforme.

Langage id Langage id
Arabe (Saoudien) 0x0401 Italien 0x0410
Basque 0x042d Japonais 0x0411
Chinois (simplifié) 0x0804 Coréen 0x0412
Chinois (traditionnel) 0x0404 Norvégien 0x0414
Croate 0x041A Polonais 0x0415
Tchèque 0x0405 Portugais (Portugal) 0x0816
Danois 0x0406 Portugais (Brésil) 0x0416
Néerlandais 0x0413 Roumain 0x0418
Anglais (Royaume-Uni) 0x0809 Russe 0x0419
Anglais (US) 0x0409 Slovaque 0x041B
Finnois 0x040B Slovène 0x0424
Français 0x040C Espagnol 0x0C0A
Allemand 0x0407 Suédois 0x041D
Grec 0x0408 Thaï 0x041E
Hébreu 0x040D Turc 0x041F
Hongrois 0x040E    

 

Si vous ne définissez pas l’ID de langue du caractère, son ID de langue sera l’ID de langue système actuel si la DLL de langue de l’agent correspondante est installée ; dans le cas contraire, la langue du personnage sera l’anglais (États-Unis).

Cette propriété détermine également la langue du texte de bulle de mot, les commandes dans le menu contextuel du caractère et le moteur de reconnaissance vocale. Il détermine également la langue par défaut pour la sortie TTS. Pour déterminer si un moteur vocal compatible est disponible pour la langue du caractère, utilisez IAgentCharacterEx::GetSRModeID ou IAgentCharacterEx::GetTTSModeID.

Si vous essayez de définir l’ID de langue d’un caractère et les ressources de langue de l’Agent, la page de codes ou une police d’affichage pour l’ID de langue n’est pas disponible, Agent renvoie une erreur et l’ID de langue du caractère reste à son dernier paramètre. La définition de cette propriété ne renvoie pas d’erreur s’il n’existe aucun moteur vocal correspondant pour la langue.

Cette propriété s’applique uniquement à l’utilisation du caractère par votre application cliente ; le paramètre n’affecte pas les autres clients du caractère ou d’autres caractères de votre application cliente.

Notes

Si vous définissez l’ID de langue du caractère sur une langue qui prend en charge le texte bidirectionnel (tel que l’arabe ou l’hébreu), mais que le système exécutant votre application n’a pas de prise en charge bidirectionnelle installée, le texte s’affiche dans la bulle de mots dans l’ordre logique plutôt que dans l’ordre d’affichage.

 

Voir aussi

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