IAgentCharacterEx::GetLanguageID

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

HRESULT GetLanguageID(
   long * plangID  // address of language ID setting
);

Récupère l’ID de langue défini pour le caractère.

  • Retourne _ la valeur S OK pour indiquer que l’opération a réussi.

plangID

Adresse d’une variable qui reçoit le paramètre 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 de 16 bits définie par Windows, composée d’un id de langue primaire et d’un id de langue secondaire. Les exemples suivants sont des valeurs pour certains langages. Pour déterminer les valeurs d’autres langages, consultez la documentation du kit de développement Platform SDK.

Langage ID Langage ID
Arabe (Arabie) 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 (États-Unis) 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 cet ID de langue pour le caractère, l’ID de langue du caractère sera l’ID de langue du système actuel.

Ce paramètre détermine également la langue pour la sortie TTS, le texte de la bulle, les commandes dans le menu contextuel du caractère et le moteur de reconnaissance vocale. Pour déterminer si un moteur de reconnaissance vocale compatible est disponible pour la langue du caractère, utilisez IAgentCharacterEx :: GetSRModeID ou IAgentCharacterEx :: GetTTSModeID.

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 l’ID de langue est défini sur une langue qui prend en charge le texte bidirectionnel (comme l’arabe ou l’hébreu), mais que le système qui exécute votre application n’a pas de prise en charge bidirectionnelle installée, le texte apparaît dans le mot-bulle dans l’ordre logique plutôt que dans l’ordre d’affichage.

Voir aussi

IAgentCharacterEx : SetLanguageID, IAgentCharacterEx :: GetSRModeID, IAgentCharacterEx :: GetTTSModeID