IAgentCharacterEx ::GetLanguageID
[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible 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 S_OK pour indiquer que l’opération a réussi.
-
plangID
-
Adresse d’une variable qui reçoit le 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 primaire et d’un ID de langue secondaire. Les exemples suivants sont des valeurs pour certaines langues. Pour déterminer les valeurs d’autres langages, consultez la documentation du Kit de développement logiciel (SDK) de plateforme.
| Langue | ID | Langue | ID |
|---|---|---|---|
| Arabe (Arabie saoudite) | 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 (anglais) | 0x0809 | Russe | 0x0419 |
| Anglais (É.-U.) | 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 système actuel.
Ce paramètre détermine également la langue de sortie TTS, le texte de bulle de mots, les commandes du menu contextuel du caractère et le moteur de reconnaissance vocale. Pour déterminer s’il existe un moteur de reconnaissance vocale compatible disponible pour la langue du caractère, utilisez IAgentCharacterEx ::GetSRModeID ou IAgentCharacterEx ::GetTTSModeID.
Cette propriété s’applique uniquement à l’utilisation de votre application cliente du caractère ; le paramètre n’affecte pas d’autres clients du caractère ou d’autres caractères de votre application cliente.
Note
Si l’ID de langue est défini 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 apparaît dans la bulle de mots dans l’ordre logique plutôt que dans l’ordre d’affichage.
Voir aussi
IAgentCharacterEx :SetLanguageID, IAgentCharacterEx ::GetSRModeID, IAgentCharacterEx ::GetTTSModeID