Affiche un frameset WEBDEV dans le navigateur de l'internaute et ferme tous les contextes de pages et de framesets en cours.
Si la fonction
FramesetUtilise est utilisée dans le code d'un bouton, le frameset sera ouvert dans la destination définie pour ce bouton (onglet "Général" de la description du champ ou fonction
ChangeDestination).
// Passage de l'application en anglais
Nation(nationAnglais)
// Réaffichage du frameset FSET_LOGIN avec libellé en anglais
FramesetUtilise(FSET_LOGIN)
Syntaxe
FramesetUtilise(<Nom du frameset> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Nom du frameset> : Chaîne de caractères
Nom du frameset à afficher.
Si ce paramètre est égal à une chaîne vide (""), le nom du frameset est celui du frameset auquel appartient l'événement en cours.
<Paramètre 1> : Type de la valeur envoyée à la page (optionnel)
Paramètre(s) à passer à l'événement "Déclarations globales" du frameset à ouvrir. Ces paramètres sont passés par référence et sont considérés comme des variables globales au frameset et à toutes les pages du frameset.
<Paramètre N> : Type de la valeur envoyée à la page (optionnel)
Paramètre(s) à passer à l'événement "Déclarations globales" du frameset à ouvrir. Ces paramètres sont passés par référence et sont considérés comme des variables globales au frameset et à toutes les pages du frameset.
Remarques
Récupération des paramètres
Pour récupérer les paramètres, dans l'événement "Déclarations globales" du frameset, indiquez en début de code la ligne suivante :
PROCEDURE <Nom du frameset>(<Paramètre 1> [,...[, <Paramètre N>]])
Principe détaillé de l'ouverture d'un frameset
La fonction
FramesetUtilise effectue les opérations suivantes :
- création un contexte de frameset sur le serveur.
- création un contexte de page sur le serveur pour toutes les pages du frameset sur le serveur.
- renvoi du frameset dans le navigateur de l'internaute.
Opérations effectuées à l'ouverture du frameset
Les différentes opérations effectuées lors de l'affichage du frameset sont les suivantes :
- Exécution des événements "Déclarations globales" et "Initialisation" du frameset.
- Ouverture des pages du frameset (exécution des événements "Déclarations globales" et "Initialisation" de chaque page).
- Code WLangage suivant l'appel à la fonction FramesetUtilise (s'il existe).
La fonction
FramesetUtilise peut être utilisée dans le cas de sites multilingues. En effet, cette fonction permet de ré-ouvrir un frameset en prenant en compte la langue spécifiée par la fonction
Nation.
Sessions prélancées
Si votre projet utilise les sessions prélancées, cette fonction ne doit pas être utilisée dans l'événement "Initialisation" du projet. Cette fonction doit être utilisée dans l'événement "Initialisation du projet après connexion au site". - Pour ré-afficher un frameset, il est conseillé d'utiliser la fonction FramesetActualise.
- Pour afficher un frameset sans fermer les contextes ouverts sur le serveur, il est conseillé d'utiliser la fonction FramesetAffiche.
- Il est déconseillé de faire suivre l'appel de la fonction FramesetUtilise d'un code WLangage.
Composante : wd280page.dll