Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible 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 primaire 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.
| 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 l’ID de langue du caractère, son ID de langue est l’ID de langue système actuel si la DLL de langue de l’agent correspondante est installée ; sinon, la langue du caractère sera l’anglais (ÉTATS-Unis).
Cette propriété détermine également la langue du texte de bulle de mot, les commandes du 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 s’il existe un moteur de reconnaissance vocale compatible 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 linguistiques de l’Agent, la page de codes ou une police d’affichage pour l’ID de langue n’est pas disponible, Agent retourne une erreur et l’ID de langue du caractère reste au dernier paramètre. La définition de cette propriété ne retourne pas d’erreur s’il n’existe pas de moteurs vocaux correspondants pour la langue.
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 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 apparaît 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