|
|
|
|
|
|
|
|
|
|
- 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.
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é. Cette fonction est réservée à des usages très particuliers. // -- 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 : | | | FrameEnCours | la 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). | | FrameParent | la 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). | | NavigateurEnCours | la destination est le navigateur en cours.
Ce paramètre peut également correspondre à la chaîne "_top" (compatibilité avec WEBDEV 1.5). | | NouveauNavigateur | la 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 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 : | | | ONAdresse | La barre d'adresse sera affichée. | | ONAscenseur | Les 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). | | ONDimension | La fenêtre du nouveau navigateur sera redimensionnable. | | ONLien | La barre des liens sera affichée. | | ONMenu | La barre de menu sera affichée. | | ONMessage | La barre de message sera affichée. | | ONOutils | La barre d'outils sera affichée. | | ONSimple | La 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 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. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|