DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques au WEB / Fonctions de gestion des pages
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
Affiche une page WEBDEV comme une popup dans la page courante avec un effet de GFI (Grisage des Fenêtres Inaccessibles). Cette fonction permet de simuler simplement une boite de dialogue en code navigateur.
Remarque : Pour afficher une page Popup, la fonction PopupAffichePage peut être utilisée :
  • soit dans le code d'un champ Bouton de type "Exécuter le code de clic navigateur uniquement". Dans ce cas, seul le code navigateur du champ Bouton sera exécuté.
  • soit dans le code d'un champ Bouton de type "Exécuter les codes serveur et navigateur" (avec envoi des valeurs au serveur). AJAX doit être activé dans le code de ce champ Bouton. Dans ce cas, les codes navigateur et serveur du champ seront exécutés.
Exemple
// Affiche la page PAGE_DétailsProduit en popup
PopupAffichePage(PAGE_DétailsProduit, (nIDProduit), popupCentre)
WEBDEV - Code Navigateur
// Affiche la page PAGE_DétailsProduit en popup
// Attend la fermeture de la page et affiche la valeur renvoyée
PopupAffichePage(PAGE_Détail, (nIDProduit), PopupAffiche_Callback, BTN_CHAMP, popupPositionXY, 10, 10)

	PROCÉDURE INTERNE PopupAffiche_Callback(RetourPagePopup)
		Trace("La popup a renvoyé : [%RetourPagePopup%]")
	FIN
Syntaxe

Afficher une page Popup à une position spécifique Masquer les détails

PopupAffichePage(<Page> [, <Paramètres> [, <Options d'affichage> [, <X> [, <Y>]]]])
<Page> : Nom de page
Nom de la page à afficher.
<Paramètres> : Liste de valeurs entre parenthèses et séparées par des virgules
Paramètres de la page à afficher. Cette liste de paramètres est de la forme :
(<Paramètre 1>, ..., <Paramètre N>)
où :
  • <Paramètre 1> : Premier paramètre de la page.
  • ...
  • <Paramètre N> : Nième paramètre de la page.
Attention :
  • Les paramètres sont passés par valeur.
  • Dans le cas d'un appel en code navigateur, les valeurs sont converties en chaînes lors de la transmission au serveur. Il est donc conseillé d'utiliser uniquement des paramètres de type simple (booléen, chaîne, entier, ...).
<Options d'affichage> : Constante optionnelle de type Entier
Options d'affichage de la popup :
popupAnnulableLa page Popup est volatile : la popup peut être fermée via la touche ESC ou lors d'un clic hors de la popup.
Cette constante peut être combinée avec une des autres constantes de positionnement de la popup.
popupBasCentreLa page Popup est placée en bas au centre de la partie visible de la page courante.
popupBasDroiteLa page Popup est placée en bas à droite de la partie visible de la page courante.
popupBasGaucheLa page Popup est placée en bas à gauche de la partie visible de la page courante.
popupCentre
(Valeur par défaut)
La page Popup est centrée dans la partie visible de la page courante.
popupCentreDroiteLa page Popup est placée au centre à droite de la partie visible de la page courante.
popupCentreGaucheLa page Popup est placée au centre à gauche de la partie visible de la page courante.
popupEpingléeLa page Popup est épinglée à la position indiquée : la Popup ne changera pas de position si la page est scrollée ou si la taille du navigateur est modifiée.
Cette constante peut être combinée avec une des autres constantes de positionnement de la Popup (à l'exclusion de popupPositionXY et popupSourisXY).
popupHautCentreLa page Popup est placée en haut au centre de la partie visible de la page courante.
popupHautDroiteLa page Popup est placée en haut à droite de la partie visible de la page courante.
popupHautGaucheLa page Popup est placée en haut à gauche de la partie visible de la page courante.
popupPositionXYLa page Popup sera ouverte aux positions X et Y indiquées.
popupSourisXYLa page Popup sera ouverte à la position de la souris. Cette constante ne peut être utilisée que dans un événement navigateur (d'un champ ou d'une page). Cette constante ne peut pas être utilisée :
  • dans les procédures navigateur.
  • dans les événements appelés directement ou indirectement depuis une procédure navigateur (par l'intermédiaire de la fonction ExécuteTraitement par exemple).
  • dans le code navigateur d'un champ Bouton ou d'un champ Lien.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
<X> : Entier optionnel
Si la constante popupPositionXY est utilisée, indique la position X d'affichage du champ Popup (par rapport au coin en haut à gauche de page). Ce paramètre est exprimé en pixels.
<Y> : Entier optionnel
Si la constante popupPositionXY est utilisée, donne la position Y d'affichage de la popup (par rapport au coin en haut à gauche du champ). Ce paramètre est exprimé en pixels.
WEBDEV - Code Navigateur

Afficher une page Popup relativement à un champ Masquer les détails

PopupAffichePage(<Page> , <Paramètres> [, <Procédure WLangage>] , <Champ de base> [, <Options d'affichage> [, <X> [, <Y>]]])
<Page> : Nom de page
Nom de la page à afficher.
<Paramètres> : Liste de valeurs entre parenthèses et séparées par des virgules
Paramètres de la page à afficher. Cette liste de paramètres est de la forme :
(<Paramètre 1>, ..., <Paramètre N>)
où :
  • <Paramètre 1> : Premier paramètre de la page.
  • ...
  • <Paramètre N> : Nième paramètre de la page.
Attention :
  • Les paramètres sont passés par valeur.
  • Dans le cas d'un appel en code navigateur, les valeurs sont converties en chaînes lors de la transmission au serveur. Il est donc conseillé d'utiliser uniquement des paramètres de type simple (booléen, chaîne, entier, ...).
<Procédure WLangage> : Nom de procédure ou procédure lambda optionnelle
Nom de la procédure WLangage (appelée "callback") appelée après la fermeture de la page. Pour plus de détails sur cette procédure, consultez Paramètres de la procédure utilisée par la fonction PopupAffichePage.
Cette procédure WLangage est une procédure navigateur et elle peut correspondre à :
  • un nom de procédure globale,
  • un nom de procédure interne,
  • une procédure lambda.
<Champ de base> : Nom de champ
Nom du champ par rapport auquel la page Popup doit être affichée.
<Options d'affichage> : Entier optionnel
Options d'affichage de la popup.
popupAnnulableLa page Popup est volatile : la popup peut être fermée via la touche ESC ou lors d'un clic hors de la popup.
Cette constante peut être combinée avec une des autres constantes de positionnement de la popup.
popupBasCentreLa page Popup est placée en bas au centre du champ.
popupBasDroiteLa page Popup est placée en bas à droite du champ.
popupBasGauche
(Valeur par défaut)
La page Popup est placée en bas à gauche du champ.
popupCentreLa page Popup est centrée par rapport au champ de base.
popupCentreDroiteLa page Popup est centrée à droite par rapport au champ de base.
popupCentreGaucheLa page Popup est centrée à gauche par rapport au champ de base.
popupHautCentreLa page Popup est placée en haut au centre par rapport au champ de base.
popupHautDroiteLa page Popup est placée en haut à droite par rapport au champ de base.
popupHautGaucheLa page Popup est placée en haut à gauche par rapport au champ de base.
popupPositionXYLa page Popup sera affichée aux positions X et Y indiquées.
<X> : Entier optionnel
Si la constante popupPositionXY est utilisée, indique la position X d'affichage de la popup (par rapport au coin en haut à gauche du champ). Ce paramètre est exprimé en pixels.
<Y> : Entier optionnel
Si la constante popupPositionXY est utilisée, donne la position Y d'affichage de la popup (par rapport au coin en haut à gauche du champ). Ce paramètre est exprimé en pixels.
Remarques
  • La page affichée est ouverte sur le serveur.
  • La page affichée pourra être masquée avec la fonction PopupFermePage.
  • Les navigateurs ne rafraîchissent pas l'affichage au milieu d'un code Javascript : les fonctions PopupAffichePage et PopupFermePage doivent être utilisées dans des événements/traitements différents. Si ces fonctions sont utilisées dans le même événement/traitement, la page n'est pas affichée.
  • Il n'est pas possible d'afficher deux pages différentes en popup en même temps avec la fonction PopupAffichePage.
  • Le GFI peut se désactiver et se personnaliser par programmation avec les fonctions PageActiveGFI et PageTauxGFI.
  • WEBDEV - Code Serveur Cette fonction ne peut pas être utilisée dans les tâches planifiées ou différées. Pour plus de détails, consultez Tâches planifiées et différées.
  • Les traitements AJAX de la page affichée par la fonction PopupAffichePage peuvent mettre à jour uniquement les champs de cette même page. Pour actualiser le contenu de champs de la page qui fait l'appel de la fonction PopupAffichePage, il est possible de :
    1. créer une procédure navigateur dans la page qui fait l'appel de la fonction PopupAffichePage. La procédure prendra en paramètres les nouvelles données, afin de les affecter dans les champs de la page.
    2. appeler cette procédure navigateur depuis les traitements de la page affichée par la fonction PopupAffichePage en passant les nouvelles valeurs en paramètres.
Composante : wd300page.dll
Version minimum requise
  • Version 26
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 18/04/2023

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