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 :
|
|
|
|
APPELER_DLL 'VaToolBx' 'VaToolBxAwsSetLocale' l_Langue l_Pays CodeRetour
Exemple 2 :
|
|
|
|
APPELER_DLL 'VaToolBx' 'VaToolBxAwsSetLocale' l_Langue l_Pays CodeRetour
