DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Fenêtre
  • Présentation
  • Créer une fenêtre popup
  • Ouvrir une fenêtre popup
  • Ouverture automatique à partir d'un champ Combo
  • Ouverture par programmation :
  • Position de la fenêtre popup
  • Programmation de la fenêtre popup
  • Fermer une fenêtre popup
  • Principe
  • Fenêtre popup et champ Combo
  • Principe
  • Valeur renvoyée par la fenêtre popup
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
Présentation
WINDEV et WINDEV Mobile permettent d'ouvrir des fenêtres sous forme de popup.
Une fenêtre popup correspond à une fenêtre apparaissant lors d'un clic sur un champ et dans laquelle l'utilisateur va pouvoir sélectionner un élément.
Une fenêtre popup peut contenir tous les types de champs.
Exemple de fenêtre popup :
Créer une fenêtre popup
Pour créer une fenêtre popup :
  1. Cliquez sur parmi les boutons d'accès rapide.
    • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Fenêtre" puis sur "Fenêtre".
    • L'assistant de création d'une fenêtre se lance.
  2. Affichez l'onglet "Standard".
  3. Sélectionnez "Vierge pour Popup".
  4. Sélectionnez si nécessaire le gabarit de la fenêtre popup et validez.
Remarque : Il est également possible d'utiliser un autre type de fenêtre en tant que fenêtre popup. Dans ce cas :
  • la barre de titre de la fenêtre sera réduite (aucun titre ne sera affiché).
  • la fenêtre ne pourra pas être maximisée ou réduite.
Ouvrir une fenêtre popup

Ouverture automatique à partir d'un champ Combo

Si la fenêtre popup est ouverte à partir d'un champ Combo, aucune programmation n'est nécessaire. Il suffit de :
  1. Cocher l'option "Fenêtre popup" dans l'onglet "Contenu" du champ.
  2. Sélectionner la fenêtre popup à ouvrir.
Java Les fenêtres popup ne peuvent pas être associées à un champ de type Combo.

Ouverture par programmation :

Les fonctions permettant d'ouvrir une fenêtre popup sont les suivantes :
OuvrePopupOuvre une fenêtre de type popup et attend sa fermeture.
OuvrePopupPositionOuvre une fenêtre de type popup en précisant sa position d'ouverture et attend sa fermeture.
Java Ces fonctions ne sont pas disponibles.

Position de la fenêtre popup

Par défaut, la fenêtre popup s'ouvre sous le champ qui ouvre la fenêtre popup (champ Combo ou champ qui exécute la fonction OuvrePopup).
S'il n'y a pas assez de place pour ouvrir la fenêtre popup, la fenêtre s'ouvrira soit au-dessus du champ, soit au-dessous du champ vers la gauche.
La fonction OuvrePopupPosition permet de paramétrer précisément la position d'ouverture de la fenêtre popup.
Java Cette fonctionnalité n'est pas disponible.

Programmation de la fenêtre popup

  • Le mot-clé MonChampPopup permet de manipuler le champ qui a ouvert une fenêtre popup.
  • Il est possible de passer des paramètres à une fenêtre popup. Les paramètres sont alors récupérés dans l'événement "Déclarations globales" de la fenêtre popup. La première ligne de code de cet événement doit correspondre à la ligne suivante :
    PROCEDURE <Nom de la fenêtre> (<Paramètre1> [, <Paramètre2> [, ...]])

    Pour plus de détails, consultez Fenêtre paramétrée.
  • Il n'est pas possible d'ouvrir une fenêtre popup depuis une fenêtre popup.
  • A partir d'une fenêtre popup, seule une fenêtre modale peut être ouverte (fonction Ouvre). L'ouverture d'une fenêtre modale depuis une fenêtre popup ne ferme pas automatiquement la fenêtre popup. Il faut traiter la valeur de retour de la fonction Ouvre et utiliser la fonction Ferme pour fermer la fenêtre popup.
Fermer une fenêtre popup

Principe

Une fenêtre popup se ferme automatiquement :
  • soit dès qu'un élément est sélectionné.
  • soit lorsque la fenêtre perd le focus.
  • soit lors de l'appui sur la touche Echap du clavier.
  • soit lors de l'appel de la fonction Ferme.
La valeur sélectionnée par l'utilisateur est renvoyée au champ qui a ouvert la fenêtre popup grâce à une des méthodes suivantes :
  • soit par le mot-clé RENVOYER présent le code de fermeture de la fenêtre,
  • soit par la fonction Ferme,
  • soit par la propriété ValeurRenvoyée utilisée avant la fermeture de la fenêtre.
Fenêtre popup et champ Combo

Principe

Dans les champs Combo, il est possible d'ouvrir directement une fenêtre popup à la place de la liste habituelle. Il suffit de cocher l'option "Fenêtre popup" dans l'onglet "Contenu" du champ et de sélectionner la fenêtre popup à ouvrir.
Remarque : Pour passer des paramètres à la fenêtre popup, il est nécessaire d'utiliser la fonction OuvrePopup.
Java Cette fonctionnalité n'est pas disponible.

Valeur renvoyée par la fenêtre popup

En règle générale, la valeur renvoyée par la fenêtre popup correspond à la valeur affichée dans le champ Combo.
Lors de la fermeture de la fenêtre popup, plusieurs cas peuvent se présenter selon le type du champ Combo :
  • Champ Combo par programmation sans saisie :
    La valeur renvoyée est recherchée dans le champ Combo.
    Si la valeur est trouvée, cette valeur est sélectionnée dans le champ.
    Si la valeur n'est pas trouvée, cette valeur est ajoutée puis sélectionnée dans le champ.
  • Champ Combo par programmation avec saisie :
    La valeur renvoyée est directement saisie dans le champ Combo.
  • Champ Combo fichier sans saisie :
    La valeur renvoyée doit correspondre à la valeur affichée dans le champ Combo.
    La valeur renvoyée est recherchée dans le champ.
    Si la valeur est trouvée, cette valeur est sélectionnée dans le champ.
    Si la valeur n'est pas trouvée, aucune valeur n'est affichée dans le champ.
  • Champ Combo fichier avec saisie :
    La valeur renvoyée est directement saisie dans le champ Combo.
La valeur renvoyée doit donc être au format utilisé par la fonction ListeAjoute. Il est tout à fait possible d'utiliser le format suivant :
RENVOYER gValeurMémorisée(ValeurMémorisée) + ValeurAffichée
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Manque d'informations
- Peut-on déplacer une popup dans une autre fenêtre ou modèle de fenêtre au lieu de devoir la recréer?
Smokie68
05 nov. 2017

Dernière modification : 14/06/2023

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