DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Bouton
  • Présentation
  • Les différents choix possibles
  • Remarque : les navigateurs Internet autorisent uniquement une seule action sur la page par traitement
  • Choisir un type de bouton
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Choisir l'action du bouton dans une page
Présentation
Lors de la définition de l'action d'un bouton dans une page, un bouton peut réaliser des opérations différentes selon le type de l'action sélectionnée.
Les différents choix possibles
Le choix de l'opération réalisée lors de l'action se fait dans la fenêtre de description du bouton (onglet "Général").
Les opérations possibles lors de l'action sont les suivants :
  • Envoyer les valeurs au serveur (submit) :
    Le bouton valide l'ensemble des champs de la page en cours et renvoie la valeur des champs au serveur. Le serveur effectue alors l'action spécifiée.
  • Ne rien envoyer au serveur :
    Le bouton effectue l'action demandée mais ne renvoie pas le contenu des champs de la page en cours au serveur.
  • Effacer le contenu des champs côté navigateur (reset) - pour compatibilité :
    Le bouton vide tous les champs de la page (sauf les champs initialisés par programmation).

Remarque : les navigateurs Internet autorisent uniquement une seule action sur la page par traitement

Certains types de bouton provoquent automatiquement une action sur la page (bouton réalisant l'opération "Envoyer les valeurs des champs au serveur (submit)").
Si les fonctions PageValide ou EmailOuvreMessagerie sont utilisées dans l'événement "Clic" navigateur de ces boutons (ou dans une procédure appelée par cet événement), cette fonction sera ignorée : seule l'action du bouton sera effectuée.
Conséquences : Les fonctions PageValide ou EmailOuvreMessagerie ne peuvent pas être utilisées dans un code provoquant (automatiquement ou non) une action. Ces fonctions sont ignorées :
  • dans le code de clic d'un bouton réalisant une action "Envoyer les valeurs au serveur (submit)".
  • dans le code de clic d'un bouton réalisant une autre opération dont l'action est différente de "Ne rien envoyer au serveur".
  • si la fonction PageValide est suivie de la fonction EmailOuvreMessagerie (dans l'événement en cours, dans une procédure appelée par l'événement en cours ou dans un autre événement appelé par la fonction Exécute).
  • si la fonction EmailOuvreMessagerie est suivie de la fonction PageValide (dans l'événement en cours, dans une procédure appelée par l'événement en cours ou dans un autre événement appelé par la fonction Exécute).
Pour utiliser les fonctions PageValide ou EmailOuvreMessagerie depuis un bouton (événement "Clic" navigateur du bouton), ce bouton doit avoir les caractéristiques suivantes (onglet "Général" de la fenêtre de description) :
  • Opération sur les champs : "Exécuter le code de clic navigateur uniquement".
  • Action : "Ne rien envoyer au serveur".
Choisir un type de bouton
Voici quelques exemples d'utilisation "classique" des boutons dans une page :
Action à effectuerExempleOpération possible lors de l'action
Envoyer les données de la page en cours au serveur pour traitementFormulaire d'enregistrement
Le bouton permet de vérifier la validité des informations saisie et affiche une page de confirmation.
Envoyer la valeur des champs au serveur (submit)
Effectuer un traitement sur le serveur, sans récupérer les données de la page en coursPage de menu constituée de boutons.
Chaque bouton permet d'afficher une page du site
Aucune
Effectuer un traitement en code navigateurExécuter un calcul simple, un contrôle de saisie, ...Aucune
Afficher une page statique du siteAfficher la page d'accueil du siteAucune
Afficher une page extérieure au siteLancer un moteur de rechercheAucune
Réinitialiser les champs de la pageVider les champs de la page en coursRéinitialiser les champs de la page (Reset)
Version minimum requise
  • Version 9
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 02/06/2022

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