PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Ouvre une fenêtre modale WINDEV ou WINDEV Mobile.
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 exécuté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.
Versions 16 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 24 et supérieures
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WEBDEV - Code ServeurWindows Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.
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.
Nouveauté 24
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WEBDEV - Code ServeurWindows Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.
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.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WEBDEV - Code ServeurWindows Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.
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 (avec ou sans guillemets)
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 multi-fenê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 iconisée, tout le projet est iconisé.
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êtesWindowsWindows MobileCode 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 : wd240obj.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