Cette fonction permet de modifier le couple (langue/pays) utilisé pour la session en cours. L'information sur le pays est facultative.
Le fait de changer le couple (langue/pays) a deux implications.
Tout d'abord, les différents caractères de séparation (séparateur décimal, séparateur de date, séparateur d'heure, séparateur des milliers) sont réactualisés pour prendre en compte les caractères standard associés à la langue et au pays. De même, le formatage des variables de type DATE et TIMESTAMP peut être modifié par la mise à jour du couple (langue/pays).
Remarque : ces caractères sont réactualisés même s'ils ont été fixés à l'aide des fonctions VaToolBxAwsSetDecimalSeparatorChar, VaToolBxAwsSetDateSeparatorChar, VaToolBxAwsSetTimeSeparatorChar, VaToolBxAwsSetGroupingSeparatorChar.
Dans un deuxième temps, si l'application est générée en mode multilingue, alors les constantes textes traduites dans la langue choisie seront utilisées.
Remarque : il est déconseillé d'utiliser cette fonction dans un traitant d'événements AJAX car elle provoque un rafraîchissement incomplet de la page.
Domaine d'application
Client Adélia Web.
Paramètres
ALPHA(2) |
Langue |
Langue (code ISO 639; 2 lettres en minuscule) |
ALPHA(2) |
Pays |
Pays (code ISO 3166; 2 lettres en majuscules) |
BOOL |
CodeRetour |
Code retour de l'opération : *VRAI si l'opération s'est déroulée correctement. *FAUX dans le cas contraire. |
Par exemple
Exemple 1:
l_Langue |
= 'fr' /* Langue : Français */ |
l_Pays |
= *BLANK / * Pas de code pays */ |
APPELER_DLL 'VaToolBx' 'VaToolBxAwsSetLocale' l_Langue l_Pays CodeRetour
Exemple 2:
l_Langue |
= 'en' /* Langue : Anglais |
l_Pays |
= 'AU' /* Pays : Australie |
APPELER_DLL 'VaToolBx' 'VaToolBxAwsSetLocale' l_Langue l_Pays CodeRetour
Liste des fonctions de la DLL VaToolBx par thème