DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion des fenêtres
  • Paramètres passés à la fenêtre à ouvrir
  • Mode d'ouverture de la fenêtre
  • Nombre de fenêtres ouvertes
  • Fermeture d'une fenêtre
  • Titre de la fenêtre à ouvrir
  • Fenêtre iconisée
  • Ouvrir une fenêtre d'un composant
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
Ouvre une fenêtre modale WINDEV.
La fonction Ouvre permet également de :
  • définir la position d'affichage de la fenêtre,
  • passer des paramètres à la fenêtre.
Lors de l'appel de la fonction Ouvre, les actions suivantes sont réalisées :
  • exécution de l'événement "Déclarations globales" de la fenêtre,
  • exécution des événements "Initialisation" des champs présents dans la fenêtre (l'ordre est indéterminé),
  • exécution de l'événement "Initialisation" de la fenêtre,
  • affichage de la fenêtre (cette fenêtre devient la fenêtre en cours).
Pour plus de détails sur les événements associés à une fenêtre, consultez Evénements associés à une fenêtre.
Remarque : Les champs de la fenêtre précédente sont désactivés.
Java En Java, les fenêtres modales apparaissent dans la barre des tâches.
Plateformes mobiles :
  • iOS et UWP : La fonction Ouvre n'est pas disponible. Utilisez à la place la fonction OuvreFenêtreMobile.
  • Android : L'utilisation de la fonction Ouvre est déconseillée sous Android. Il est recommandé d'utiliser la fonction OuvreFenêtreMobile. S'il est nécessaire de traiter la valeur renvoyée par la fenêtre, utilisez le l'événement "Fermeture d'une fenêtre fille" de la fenêtre appelante.
WEBDEV - Code ServeurWindowsLinux Cette fonction est disponible uniquement pour simplifier la Webisation de projets WINDEV. Dans un site WEBDEV, cette fonction se comporte comme la fonction PageAfficheDialogue.
Exemple
// Ouverture et repositionnement de la fenêtre "SaisieFenêtre"
// Les paramètres Valeur1 et Valeur2 sont passés à l'événement
// "Déclarations globales" de la fenêtre "SaisieFenêtre"
// ValeurRenvoyée récupérera la valeur renvoyée
// lors de la fermeture de la fenêtre "SaisieFenêtre"
ValeurRenvoyée = Ouvre("SaisieFenêtre, 10, 15", Valeur1, Valeur2)
// Ouvrir une fenêtre à une position donnée en utilisant des variables
x, y sont des entiers
x = SourisPosX(spEcran)
y = SourisPosY(spEcran)
Ouvre(ChaîneConstruit("FEN_PopUp,%1,%2", y, x))
Syntaxe
<Résultat> = Ouvre(<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 ou nom de fenêtre
Correspond :
  • au nom de la fenêtre à ouvrir.
  • au nom et chemin complet de la fenêtre (fichier ".WDW") à ouvrir.
Par défaut, la fenêtre est affichée selon la position définie sous l'éditeur. Il est possible de définir la position d'affichage de la fenêtre. Le nom de la fenêtre est alors complété par les coordonnées d'affichage de la fenêtre à son ouverture. Ce paramètre est de la forme :
"<Nom de la fenêtre>, <Y>, <X>"
où :
  • <Nom de la fenêtre> : nom (ou nom et chemin complet) de la fenêtre à ouvrir.
  • <Y> : Ordonnée (en pixels) d'affichage de la fenêtre (par rapport au coin haut gauche de l'écran ou de la fenêtre mère).
  • <X> : Abscisse (en pixels) d'affichage de la fenêtre (par rapport au coin haut gauche de l'écran ou de la fenêtre mère).
Remarque : Si la fenêtre est déclarée centrée sous l'éditeur, les coordonnées sont ignorées.
<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. Ce paramètre est passé par référence et il est considéré comme une variable globale à 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. Ce paramètre est passé par référence et il est considéré comme une variable globale à la fenêtre.
Remarques

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

Les paramètres sont récupérés dans l'événement de "Déclarations globales" de la fenêtre. Il suffit de saisir la ligne de code suivante au début du code de l'événement :
PROCEDURE <Nom de la fenêtre>(<Paramètre1> [, <Paramètre2> [, ...]])

Pour plus de détails, consultez Fenêtre paramétrée.

Mode d'ouverture de la fenêtre

L'ouverture de la fenêtre est modale :
  • le résultat de la fonction Ouvre ne sera connu qu'après fermeture de la fenêtre,
  • l'utilisateur ne pourra pas cliquer dans une des fenêtres parentes de la fenêtre en cours.
Pour gérer le multifenêtrage, utilisez les fonctions OuvreFille ou OuvreSoeur.
Pour gérer le MDI, utilisez la fonction MDIOuvre.

Nombre de fenêtres ouvertes

Le nombre de fenêtres pouvant être ouvertes simultanément dépend de la mémoire disponible.

Fermeture d'une fenêtre

Une fenêtre ouverte avec la fonction Ouvre peut être fermée avec la fonction Ferme (sans paramètre) à partir de n'importe quel événement de la fenêtre, ou de l'un des champs de la fenêtre.
Si une fenêtre mère est fermée, ses fenêtres filles sont également fermées.

Titre de la fenêtre à ouvrir

Par défaut, le titre de la fenêtre est celui défini sous l'éditeur.
Pour modifier le titre de la fenêtre, utilisez les fonctions TitreSuivant ou TitreEnCours.
WINDEVEtats et RequêtesWindowsJavaCode Utilisateur (MCU)

Fenêtre iconisée

Si la fenêtre en cours est icônisée, tout le projet est icônisé.
L'icône affichée est :
  • celle de la fenêtre en cours si la fenêtre en cours a une icône,
  • celle du projet en cours si la fenêtre en cours n'a pas d'icône.
WINDEVEtats et RequêtesWindowsCode Utilisateur (MCU)

Ouvrir une fenêtre d'un composant

Pour ouvrir une fenêtre d'un composant, il suffit d'utiliser directement le nom de la fenêtre du composant (le composant étant intégré dans le projet). Par exemple :
Ouvre(FenêtreDuComposant)
En cas de conflit avec un élément du projet, il suffit de préfixer le nom de l'élément par le nom du composant. Par exemple :
Ouvre(MonComposant.Fenêtre)
Pour utiliser le nom de la fenêtre dans une variable, il est nécessaire de préciser le nom du composant. Par exemple :
sFenêtre est une chaîne = "MonComposant.MaFenêtre"
Ouvre(sFenêtre)
Composante : wd290obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Ouvrir les fenêtres internes
Il est possible d'ouvrir les fenêtres interne avec la commande Ouvre(<nom de fenêtre interne> [, paramètres [, ...]])
Alexandre LECLERC
26 juin 2015

Dernière modification : 20/03/2023

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