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
  • Quel mode d'ouverture choisir ?
  • 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 en précisant sa position d'ouverture et attend sa fermeture.
Cette fonction doit être utilisée dans le code d'un champ (code de clic d'un bouton par exemple).
Exemple
// Ouverture d'une fenêtre de sélection de couleur
MaCouleur est un entier 
MaCouleur = OuvrePopupPosition(FEN_CouleurFenSélecteur, popEnDessous + popAlignéADroite + ...
	popSelonChamp, BTN_CouleurAction, CouleurCourante)
// Si une couleur a été sélectionnée 
// (MaCouleur <= 0 si on annule la fenêtre)
SI MaCouleur > 0 ALORS
	// On conserve la nouvelle couleur sélectionnée
	CouleurCourante = MaCouleur
	// Changement de couleur du rectangle du champ Bouton
	BTN_Couleur.Libellé = gRectangle(0, 0, 72, 16, CouleurCourante, 0)
FIN
Syntaxe
<Résultat> = OuvrePopupPosition(<Fenêtre popup> , <Mode d'ouverture> [, <Champ de référence>] [, <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 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> : Nom de fenêtre
Nom de la fenêtre à ouvrir.
<Mode d'ouverture> : Combinaison de constantes
Précise la position et le mode d'ouverture de la fenêtre popup. Ces constantes sont les suivantes :
popAlignéADroiteLe bord droit de la fenêtre popup sera calé sur le bord droit du champ. La fenêtre popup s'étend sur la gauche.
(Correspond à la constante poGauche dans les versions précédentes).
popAlignéAGaucheLe bord gauche de la fenêtre popup sera calé sur le bord gauche du champ. La fenêtre popup s'étend sur la droite.
(Correspond à la constante poDroite dans les versions précédentes).
popAuDessusLa fenêtre popup s'ouvrira au dessus du champ appelant.
(Correspond à la constante poHaut dans les versions précédentes).
popCentréFenêtreLa fenêtre popup est centrée par rapport à la fenêtre parente.
popCentréHorizontalementLa fenêtre popup est centrée horizontalement avec le champ appelant.
popDéfaut
(Valeur par défaut)
Par défaut, la combinaison de constantes popAlignéAGauche + popEnDessous est utilisée.
popDésactiveRepostionnementAutoDébranche le repositionnement automatique si la fenêtre popup risque de ne pas être complètement visible à l'écran.
(Correspond à la constante poPositionFixe dans les versions précédentes).
popEnDessousLa fenêtre popup s'ouvrira au dessous du champ appelant.
(Correspond à la constante poBas dans les versions précédentes).
popSelonChampOuvre la fenêtre popup en fonction de la position d'un champ différent du champ appelant. Dans ce cas:
  • il faut préciser le nom du champ (paramètre <Nom du champ>).
  • le nom du champ sera automatiquement récupéré par le mot-clé MonChampPopup.
(Correspond à la constante poSelonChamp dans les versions précédentes).
<Champ de référence> : Nom de champ optionnel
Nom du champ sous lequel la fenêtre popup doit s'ouvrir. Ce paramètre doit être précisé uniquement si la constante poSelonChamp a été utilisée.
<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 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.
  • La fenêtre ouverte par la fonction OuvrePopupPosition 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 OuvrePopupPosition. 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. Il suffit d'indiquer en début de code la ligne suivante :
PROCEDURE <Nom de la fenêtre> (<Paramètre1> [, <Paramètre2> [, ...]])
Pour plus de détails, consultez Fenêtre paramétrée.

Quel mode d'ouverture choisir ?

Remarques :
  • si vous utilisez uniquement la constante poBas, la fenêtre popup sera ouverte à la position poDroite + poBas.
  • si vous utilisez uniquement la constante poHaut, la fenêtre popup sera ouverte à la position poDroite + poHaut.

Limites

  • La fonction OuvrePopupPosition doit être exécutée à partir d'un code de champ.
  • Le champ à partir duquel la fonction OuvrePopupPosition 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.
Classification Métier / UI : Code UI
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