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 (à l'exception des services 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 :
|
|
|
|
APPELER_DLL 'VaToolBx' 'VaToolBxAwsSetLocale' l_Langue l_Pays CodeRetour
Exemple 2 :
|
|
|
|
APPELER_DLL 'VaToolBx' 'VaToolBxAwsSetLocale' l_Langue l_Pays CodeRetour
