DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques au WEB / Fonctions de gestion des pages
  • Paramètres passés à la page à ouvrir
  • Sites multilingues
  • Principe détaillé de l'ouverture d'une page
  • Evénements et codes exécutés lors de l'appel à la fonction PageUtilise
  • Ouvrir une page d'un composant externe
  • Divers
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Affiche une page WEBDEV dans le navigateur de l'internaute et ferme tous les contextes de pages actuellement ouverts sur le serveur.
Exemple
// Passage de l'application en anglais
Nation(nationAnglais)
// Réaffichage de la page PAGE_Login avec libellé en anglais
PageUtilise(PAGE_Login)
Syntaxe
PageUtilise(<Page> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Page> : Nom de page
Nom de la page à afficher.
Si ce paramètre est égal à une chaîne vide (""), le nom de la page est le celui de la page auquel appartient l'événement en cours.
En mode test, si la page à ouvrir se situe dans un répertoire différent du répertoire du projet, il faut préciser le chemin complet de la page.
<Paramètre 1> : Type de la valeur envoyée à la page (optionnel)
Paramètre(s) à passer à l'événement d'ouverture de la page à ouvrir (événement "Déclarations globales" de la page). Ces paramètres sont passés par référence et sont considérés comme des variables globales à la page.
<Paramètre N> : Type de la valeur envoyée à la page (optionnel)
Paramètre(s) à passer à l'événement d'ouverture de la page à ouvrir (événement "Déclarations globales" de la page). Ces paramètres sont passés par référence et sont considérés comme des variables globales à la page.
Remarques

Paramètres passés à la page à ouvrir

Les paramètres sont récupérés dans l'événement d'ouverture de la page (événement "Déclarations globales" de la page). Il suffit d'indiquer au début de l'événement "Déclarations globales" de la page, la ligne suivante :
PROCEDURE <Nom de la page> (<Paramètre1> [,...[, <Paramètre N>]]])

Sites multilingues

La fonction PageUtilise peut être utilisée dans le cas de sites multilingues. En effet, cette fonction permet de ré-ouvrir une page en prenant en compte la langue spécifiée par la fonction Nation.

Principe détaillé de l'ouverture d'une page

La fonction PageUtilise effectue les opérations suivantes :
  • fermeture de tous les contextes ouverts sur le serveur
  • création un contexte de page sur le serveur
  • renvoi de la page dans le navigateur de l'internaute.
Remarque : Si la fonction PageUtilise est utilisée dans le code d'un champ Bouton, la page sera ouverte dans la destination définie pour ce champ Bouton (onglet "Général" de la description du champ ou fonction ChangeDestination).

Evénements et codes exécutés lors de l'appel à la fonction PageUtilise

Les différents événements et codes exécutés lors de l'affichage de la page sont les suivants :
  • Code d'ouverture de la page (événement "Déclarations globales" de la page).
  • Evénement "Initialisation" des champs de la page.
  • Affichage de la page dans le navigateur.
  • Codes Javascript associés à la page et aux champs.
  • Code WLangage suivant l'appel à la fonction PageUtilise (s'il existe).
WEBDEV - Code ServeurWindows

Ouvrir une page d'un composant externe

Pour ouvrir une page d'un composant externe, il suffit d'utiliser directement le nom de la page du composant externe (le composant étant intégré dans le projet). Par exemple :
PageUtilise(PageDuComposant)
En cas de conflit avec un élément du projet, il suffit de préfixer le nom de l'élément par le nom du composant externe. Par exemple :
PageUtilise(MonComposant.Page)
Pour utiliser le nom de la page dans une variable, il est nécessaire de préciser le nom du composant externe. Par exemple :
sPage est une chaîne = "MonComposant.MaPage"

PageUtilise(sPage)

Divers

  • Pour ré-afficher une page, il est conseillé d'utiliser la fonction PageActualise.
  • Pour afficher une page sans fermer les contextes ouverts sur le serveur, il est conseillé d'utiliser la fonction PageAffiche.
  • Il est déconseillé de faire suivre l'appel de la fonction PageUtilise d'un code WLangage.
  • 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 lors d'une connexion à une session prélancée".
Composante : wd300page.dll
Version minimum requise
  • Version 9
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/09/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale