PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Caractéristiques de la fenêtre popup
  • Paramètres passés à la fenêtre à ouvrir
  • Quel mode d'ouverture choisir ?
  • Limites
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
OuvrePopupPosition (Fonction)
En anglais : OpenPopupPosition
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, poBas + poDroite + poSelonChamp, ...
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 bouton
BTN_Couleur..Libellé = gRectangle(0, 0, 72, 16, CouleurCourante, 0)
FIN
Syntaxe
<Résultat> = OuvrePopupPosition(<Nom de la fenêtre> , <Mode d'ouverture> [, <Nom du champ>] [, <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.
<Nom de la fenêtre> : Chaîne de caractères (avec ou sans guillemets)
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 :
poBasLa fenêtre popup s'ouvrira au dessous du champ appelant
poDroiteLe bord gauche de la fenêtre popup sera calé sur le bord gauche du champ. La fenêtre popup s'étend sur la droite.
poGaucheLe bord droit de la fenêtre popup sera calé sur le bord droit du champ. La fenêtre popup s'étend sur la gauche.
poHautLa fenêtre popup s'ouvrira au dessus du champ appelant
poPositionFixeDébranche le repositionnement automatique si la popup risque de ne pas être complètement visible à l'écran
poSelonChampOuvre 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.
<Nom du champ> : Chaîne de caractères (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 poup. 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.
Composante : wd240obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire