PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Attention : une seule action peut être effectuée à la fois sur la même page
  • Utilisation de PageValide depuis un champ Bouton
  • Le nom du champ Bouton correspond à une variable ou une chaîne construite.
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
PageValide (Fonction)
En anglais : PageSubmit
Valide la page spécifiée et lance l'exécution d'un bouton. Seul le code serveur du bouton est exécuté.
Exemple
// -- Code navigateur de clic du bouton BTN_Fermer
// Valide la page et lance l'exécution du code de clic serveur de BTN_Bouton1
PageValide("", "BTN_Bouton1")
// -- Code Navigateur du clic sur une image
// Lance le code de clic d'un bouton de type SUBMIT
// pour que le contenu des champs de la page soit transmis au serveur
 
// Le bouton BTN_CHOIX_FAMILLE ouvre une page dans un nouveau navigateur simplifié
PageValide("", "BTN_CHOIX_FAMILLE", NouveauNavigateur, "Choix Famille", ONSimple)
Syntaxe
PageValide(<Page> , <Bouton> [, <Destination> [, <Fenêtre du navigateur> [, <Options> [, <Largeur> [, <Hauteur> [, <Position horizontale> [, <Position verticale> [, <Paramètres Javascript>]]]]]]]])
<Page> : Nom de page
  • Nom de la page à valider,
  • Chaîne vide ("") pour valider la page en cours.
La page à valider doit faire partie des pages actuellement affichées sur le navigateur.
<Bouton> : Nom de champ
Nom du champ Bouton dont le code de clic serveur sera exécuté. Ce champ doit appartenir à la page spécifiée.
<Destination> : Chaîne de caractères ou constante optionnelle
Nom de la frame de destination. <Destination> peut également prendre les valeurs suivantes :
FrameParentla destination est le conteneur de la page en cours (frameset parent, navigateur parent).
Ce paramètre peut également correspondre à la chaîne "_parent" (compatibilité avec WEBDEV 1.5).
FrameEnCoursla destination est le cadre en cours (valeur par défaut).
Ce paramètre peut également correspondre à la chaîne "_self" (compatibilité avec WEBDEV 1.5).
NavigateurEnCoursla destination est le navigateur en cours.
Ce paramètre peut également correspondre à la chaîne "_top" (compatibilité avec WEBDEV 1.5).
NouveauNavigateurla destination est un nouveau navigateur (une nouvelle fenêtre de navigateur est ouverte). Les paramètres suivants de la fonction PageValide permettent de configurer cette nouvelle fenêtre.
Ce paramètre peut également correspondre à la chaîne "_blank" (compatibilité avec WEBDEV 1.5).
<Fenêtre du navigateur> : : Chaîne de caractères optionnelle (avec guillemets)
Nom de la fenêtre du nouveau navigateur si <Destination> est égal à la constante NouveauNavigateur. Ce paramètre permet de réafficher une page dans un navigateur portant le même nom (si plusieurs navigateurs sont ouverts sur le poste de l'internaute).
<Options> : Constante ou combinaison de constantes de type entier (optionnelle)
Paramètres de la fenêtre du nouveau navigateur si <Destination> est égal à la constante NouveauNavigateur :
ONAdresseLa barre d'adresse sera affichée.
ONAscenseurLes barres de défilement seront affichées.
ONComplet
(Valeur par défaut)
La fenêtre du nouveau navigateur sera complète (équivalent à la combinaison de toutes les constantes).
ONDimensionLa fenêtre du nouveau navigateur sera redimensionnable.
ONLienLa barre des liens sera affichée.
ONMenuLa barre de menu sera affichée.
ONMessageLa barre de message sera affichée.
ONOutilsLa barre d'outils sera affichée.
ONSimpleLa fenêtre du nouveau navigateur sera minimale (aucune combinaison de constantes).
<Largeur> : Entier optionnel
Largeur en pixels de la fenêtre du nouveau navigateur.
<Hauteur> : Entier optionnel
Hauteur en pixels de la fenêtre du nouveau navigateur.
<Position horizontale> : Entier optionnel
Position horizontale en pixels de la fenêtre du nouveau navigateur (par rapport au coin haut gauche de l'écran).
<Position verticale> : Entier optionnel
Position verticale en pixels de la fenêtre du nouveau navigateur (par rapport au coin haut gauche de l'écran).
<Paramètres Javascript> : Chaîne de caractères optionnelle (avec guillemets)
Autres paramètres Javascript à utiliser lors de l'ouverture d'un nouveau navigateur si <Destination> est égal à la constante NouveauNavigateur.
Remarques

Attention : une seule action peut être effectuée à la fois sur la même page

La fonction PageValide provoque une action sur la page affichée dans le navigateur de l'internaute. Or les navigateurs Internet autorisent uniquement une seule action sur la page par traitement.
Par exemple, si un traitement envoie une page au serveur (fonction PageValide) et ouvre le logiciel de messagerie (fonction EmailOuvreMessagerie), seule la dernière action (ouverture de la messagerie) sera effectuée.
Attention : Certains types de bouton provoquent automatiquement une action sur la page (bouton de type "envoi au serveur", bouton de type "autre" dont l'action est différente de "aucune"). Si la fonction PageValide est utilisée dans le traitement de clic navigateur de ces boutons (ou dans une procédure appelée par ce traitement), cette fonction sera ignorée : seule l'action du bouton sera effectuée.
Conséquences : La fonction PageValide ne peut pas être utilisée dans un code provoquant (automatiquement ou non) une action. Cette fonction est ignorée :
  • Dans le code de clic d'un bouton de type "envoi au serveur".
  • Dans le code de clic d'un bouton de type "autre" dont l'action est différente de "aucune".
  • Si elle est suivie de l'instruction PageValide ou EmailOuvreMessagerie (dans le traitement en cours, dans une procédure appelée par le traitement en cours, ou dans un autre traitement appelé par la fonction Exécute).

Utilisation de PageValide depuis un champ Bouton

Pour utiliser la fonction PageValide depuis un champ Bouton (code de clic navigateur du champ), ce champ Bouton doit avoir les caractéristiques suivantes :
  • Type du bouton : "Autre".
  • Action : "Aucune".

Le nom du champ Bouton correspond à une variable ou une chaîne construite.

Si le nom du champ Bouton correspond à une variable ou une chaîne construite (ex : "CHAMP"+nNumeroChamp), aucune vérification n'est possible lors de la compilation. Toute erreur provoquera une erreur Javascript ou HTTP au moment de l'utilisation de la fonction.
Composante : WDJS.DLL
Version minimum requise
  • Version 9
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire