|
|
|
|
|
|
|
|
|
|
- Caractéristiques de la fenêtre popup
- Paramètres passés à la fenêtre à ouvrir
- Quel mode d'ouverture choisir ?
- Limites
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).
MaCouleur est un entier
MaCouleur = OuvrePopupPosition(FEN_CouleurFenSélecteur, popEnDessous + popAlignéADroite + ...
popSelonChamp, BTN_CouleurAction, CouleurCourante)
SI MaCouleur > 0 ALORS
CouleurCourante = MaCouleur
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éADroite | Le 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éAGauche | Le 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). | | popAuDessus | La fenêtre popup s'ouvrira au dessus du champ appelant.
(Correspond à la constante poHaut dans les versions précédentes). | | popCentréFenêtre | La fenêtre popup est centrée par rapport à la fenêtre parente. | | popCentréHorizontalement | La 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ésactiveRepostionnementAuto | Dé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). | | popEnDessous | La fenêtre popup s'ouvrira au dessous du champ appelant.
(Correspond à la constante poBas dans les versions précédentes). | | popSelonChamp | Ouvre 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> [, ...]])
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
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|