DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion des fenêtres
  • Caractéristiques de la fenêtre popup
  • Paramètres passés à la fenêtre à ouvrir
  • Limites
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Ouvre une fenêtre de type popup et attend sa fermeture. Cette fonction doit être utilisée dans le code d'un champ (code de clic d'un bouton par exemple).
Remarque : Pour personnaliser la position de la popup, utilisez la fonction OuvrePopupPosition.
Exemple
// Ouverture d'une fenêtre de sélection de couleur
MaCouleur est un entier 
MaCouleur = OuvrePopup(FEN_CouleurFenSélecteur)
// Si une couleur a été sélectionnée 
// (nCouleur <= 0 si on annule la fenêtre)
SI MaCouleur > 0 ALORS
	// Changement de couleur du rectangle du bouton
	BTN_Couleur.Libellé = gRectangle(0, 0, 72, 16, MaCouleur, 0)
FIN
Syntaxe
<Résultat> = OuvrePopup(<Nom de la fenêtre> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Résultat> : Type correspondant à la valeur récupérée (optionnel)
Valeur renvoyée par la fenêtre popup lors de sa fermeture. Cette valeur est renvoyée :
  • soit par le mot-clé RENVOYER présent dans l'événement "Fermeture" associé à la fenêtre,
  • soit par la fonction Ferme,
  • soit par la propriété ValeurRenvoyée utilisée avant la fermeture de la fenêtre.
<Nom de la fenêtre> : Chaîne de caractères
Nom de la fenêtre à ouvrir.
<Paramètre 1> : Type de la valeur envoyée à la fenêtre (optionnel)
Premier paramètre à passer à l'événement "Déclarations globales" de la fenêtre à ouvrir. Ces paramètres sont passés par référence et sont considérés comme des variables globales à la fenêtre.
<Paramètre N> : Type de la valeur envoyée à la fenêtre (optionnel)
Nième paramètre à passer à l'événement "Déclarations globales" de la fenêtre à ouvrir. Ces paramètres sont passés par référence et sont considérés comme des variables globales à la fenêtre.
Remarques

Caractéristiques de la fenêtre popup

  • La fenêtre se ferme automatiquement si elle perd le focus ou lors de l'appel à la fonction Ferme. La valeur courante 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 dans l'événement "Fermeture" associé à la fenêtre,
    • soit par la fonction Ferme,
    • soit par la propriété ValeurRenvoyée utilisée avant la fermeture de la fenêtre.
  • La fenêtre ouverte par la fonction OuvrePopup adopte le style des fenêtres popup. Si une barre de titre a été définie sous l'éditeur, cette barre de titre est réduite, et la fenêtre ne peut être maximisée ou réduite.
  • La fenêtre popup s'ouvre par défaut sous le champ qui exécute la fonction OuvrePopup. Si il n'y a pas assez de place pour ouvrir la fenêtre, la fenêtre s'ouvrira soit au-dessus du champ, soit au-dessous du champ vers la gauche.

Paramètres passés à la fenêtre à ouvrir

Les paramètres sont récupérés dans l'événement "Déclarations globales" de la fenêtre. 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.

Limites

  • La fonction OuvrePopup doit être exécutée à partir d'un code de champ.
  • Le champ à partir duquel la fonction OuvrePopup est exécutée doit être visible.
  • Il n'est pas possible d'ouvrir à partir d'une fenêtre popup une fenêtre qui n'est pas modale. Il est nécessaire d'utiliser la fonction Ouvre pour ouvrir une fenêtre. L'ouverture d'une fenêtre modale depuis une fenêtre popup ne ferme pas automatiquement la fenêtre popup. Dans ce cas, il faut traiter la valeur de retour de la fonction Ouvre et utiliser la fonction Ferme pour fermer la fenêtre popup.
  • Il n'est pas possible d'ouvrir une fenêtre popup depuis une fenêtre popup.
Liste des exemples associés :
Calendrier Popup Exemples unitaires (WINDEV Mobile) : Calendrier Popup
[ + ] Mise en place d'une popup calendrier de sélection de date.
Composante : wd300obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
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