DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Plan
  • Présentation
  • Affecter un ou plusieurs champs à un ou plusieurs plans
  • Sélectionner le plan affiché sous l'éditeur
  • Edition des plans sous l'éditeur de fenêtres
  • Gestion des plans
  • Afficher la fenêtre de gestion des plans
  • Nommer les plans
  • Modifier l'ordre des plans
  • Ajouter ou supprimer des plans
  • Changer de plan par programmation
  • Changer de plan dans une fenêtre
  • Changer de plan dans un état
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
Présentation
Les plans permettent de regrouper les champs d'une fenêtre. Un plan est une "couche" d'une fenêtre. Chaque fenêtre peut être constituée de plusieurs plans.
Les champs peuvent être placés sur différents plans. Un seul plan peut être affiché à la fois aussi bien dans l'éditeur de fenêtres que lors de l'exécution du programme.
Chaque champ de la fenêtre peut :
  • n'appartenir à aucun plan : il sera toujours affiché, quel que soit le plan en cours
  • appartenir à un plan. Ce champ ne sera affiché que lorsque le plan correspondant sera actif (c'est-à-dire visible).
  • appartenir à plusieurs plans. Ce champ sera affiché lorsque un des plans associés au champ sera actif (c'est-à-dire visible).
Remarques :
  • Les plans sont également disponibles dans les états. Les plans dans les états permettent notamment de remplacer les blocs de substitution : il suffit de placer les champs sur plusieurs plans et d'activer le plan voulu lors de l'impression.
  • WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP Les plans sont utilisables sur les pages et les champs conteneurs. Pour plus de détails, consultez Les plans en WEBDEV
  • WINDEVWINDEV Mobile L'éditeur de fenêtres propose une gestion des plans avancée permettant notamment de nommer les plans. Pour plus de détails, consultez Edition des plans sous l'éditeur de fenêtres.
Affecter un ou plusieurs champs à un ou plusieurs plans
Pour affecter un ou plusieurs champs à un ou plusieurs plans :
  1. Sélectionnez le ou les champs.
  2. Sélectionnez :
    • Pour un champ d'une fenêtre, l'option "Associer .. à un plan" du menu contextuel du champ ou de la sélection de champs.
    • Pour un champ d'un état, l'option "Associer à un plan" du menu contextuel du champ ou de la sélection de champs.
  3. Dans la fenêtre qui s'affiche, choisissez :
    • "Aucun plan" si le champ ne doit pas être associé à un plan,
    • un des plans disponibles.
    • plusieurs plans (pour cela, maintenez la touche Ctrl enfoncée pendant la sélection des plans).
Remarques :
  • Le nombre de plans est illimité. Cependant, l'éditeur de fenêtres ou d'états peut empêcher de sélectionner les plans supérieurs à 98.
  • Un champ peut aussi être affecté à un plan depuis la fenêtre de description du champ :
    • sous l'éditeur de fenêtres : onglet "Détail", option "Plan".
    • sous l'éditeur d'états : onglet "UI", option "Plan".
  • Lors de l'affectation d'un champ à un plan, le champ peut ne plus apparaître dans la fenêtre ou l'état en cours : le plan en cours est différent du plan affecté au champ.
  • La fenêtre d'affectation à un plan liste les plans utilisés puis les plans vierges. Les boutons au bas de cette fenêtre permettent de simplifier le déplacement entre les différents types de plans.
Sélectionner le plan affiché sous l'éditeur
Pour afficher un plan spécifique sous l'éditeur, vous pouvez :
  • Sous l'éditeur de fenêtres : sous le volet "Fenêtre", dans le groupe "Associer", déroulez "Plans". Dans la fenêtre qui s'affiche, il suffit de choisir le plan à afficher dans la section "Navigation".
  • Sous l'éditeur d'états : sous le volet "Modification", dans le groupe "Plans", déroulez "Plans". Dans la fenêtre qui s'affiche, il suffit de choisir le plan à afficher dans la section "Navigation".
  • Utiliser les touches Pg Prec et Pg Suiv. Ces touches permettent d'afficher les différents plans de la fenêtre ou de l'état en cours.
  • Utiliser les touches Ctrl + Pg Prec et Ctrl + Pg Suiv. Ces touches permettent d'afficher les différents plans contenant des champs (plans non vides) de la fenêtre ou de l'état en cours.
  • Saisir directement le numéro du plan à afficher dans la barre de message de l'éditeur de fenêtres ou d'états.
WINDEVWINDEV Mobile
Edition des plans sous l'éditeur de fenêtres

Gestion des plans

La gestion des plans peut être réalisée depuis l'éditeur de fenêtres. Il est possible de :

Afficher la fenêtre de gestion des plans

Pour afficher la fenêtre de gestion des plans (et visualiser les différents plans de la fenêtre) :
  1. Sous le volet "Fenêtre", dans le groupe "Associer", déroulez "Plans" et sélectionnez l'option "Editer les plans" (ou les touches de raccourcis Alt + Page suiv).
  2. La fenêtre affichée présente un aperçu (une vignette) de tous les plans de la fenêtre. Ces vignettes sont classées selon leur numéro d'ordre.
Remarque : Tous les plans contenant des champs sont affichés. Les plans vides présents entre deux plans contenant des champs sont également affichés : ils apparaissent grisés.

Nommer les plans

Par défaut, les plans sont numérotés. Si un plan est supprimé, tous les plans suivants sont automatiquement renumérotés. Pour ne pas dépendre du numéro du plan, l'éditeur de fenêtres permet de nommer et de réorganiser les plans d'une fenêtre.
Pour nommer les plans :
  1. Dans la fenêtre de gestion des plans, sélectionnez la vignette du plan à renommer.
  2. Cliquez sur l'icône "Crayon" :
  3. Saisissez le nom du plan dans la zone qui s'affiche :
  4. Validez. Le plan est nommé. Le nom apparaît au-dessus de la vignette du plan.
  5. Validez la fenêtre de gestion des plans. Le nom du plan apparaît dans l'éditeur de fenêtres, sous le numéro du plan.
Remarque : Cas des modèles de fenêtres : Il est possible de nommer des plans dans des modèles de fenêtres. Si une fenêtre utilisant un modèle surcharge le nommage des plans du modèle, le nommage des plans ne sera plus mis à jour lors de la mise à jour du modèle.

Modifier l'ordre des plans

Par défaut, les plans sont affichés selon leur ordre de création. La fenêtre de gestion des plans permet de modifier l'ordre des plans.
Pour modifier l'ordre des plans :
  1. Dans la fenêtre de gestion des plans, sélectionnez la vignette du plan à déplacer.
  2. Réalisez un "Drag and Drop" de la vignette vers la nouvelle position voulue : les vignettes représentant les autres plans se déplacent afin de visualiser la position finale du plan déplacé.
  3. Lâcher la vignette du plan déplacé à son nouvel emplacement. En cas de doute, le numéro du plan d'insertion est demandé.
  4. Tous les plans concernés sont renumérotés. Les noms des plans restent inchangés.
  5. Validez la fenêtre de gestion des plans pour prendre en compte les modifications.
Pour échanger la position de deux plans :
  1. Dans la fenêtre de gestion des plans, sélectionnez les vignettes des deux plans dont les positions doivent être échangées (utilisez la touche Ctrl pour effectuer une multisélection).
  2. Affichez le menu contextuel de la sélection (clic droit) et sélectionnez l'option "Echanger".
  3. Les vignettes des deux plans sont échangées et la renumérotation des plans est réalisée si nécessaire.
  4. Validez la fenêtre de gestion des plans pour prendre en compte les modifications.

Ajouter ou supprimer des plans

La fenêtre de gestion des plans permet d'ajouter ou de supprimer des plans vides.
Pour ajouter un plan vide :
  1. Dans la fenêtre de gestion des plans, sélectionnez la vignette du plan devant lequel un plan vide doit être inséré.
  2. Affichez le menu contextuel de la sélection (clic droit) et sélectionnez l'option "Insérer un plan vide".
  3. Le plan vide est inséré et tous les plans concernés sont renumérotés. Les noms des plans restent inchangés.
  4. Validez la fenêtre de gestion des plans pour prendre en compte les modifications.
Pour ajouter un ensemble de plans vides :
  1. Dans la fenêtre de gestion des plans, sélectionnez la vignette du plan devant lequel des plans vides doivent être insérés.
  2. Affichez le menu contextuel de la sélection (clic droit) et sélectionnez l'option "Commencer au plan".
  3. Dans la fenêtre qui s'affiche, indiquez à quel numéro ce plan doit être positionné.
  4. Validez. Autant de plans vides que nécessaire sont inséré devant le plan sélectionné. Tous les plans concernés sont renumérotés. Les noms des plans restent inchangés.
  5. Validez la fenêtre de gestion des plans pour prendre en compte les modifications.
Remarque : Si plus de 6 plans vides sont affichés à la suite, seul le premier et le dernier plan vide sont affichés dans la fenêtre de gestion des plans.
Pour supprimer un plan vide :
  1. Dans la fenêtre de gestion des plans, sélectionnez la vignette du plan vide à supprimer.
  2. Affichez le menu contextuel de la sélection (clic droit) et sélectionnez l'option "Supprimer".
  3. Le plan vide est supprimé et tous les plans concernés sont renumérotés. Les noms des plans restent inchangés.
  4. Validez la fenêtre de gestion des plans pour prendre en compte les modifications.
Changer de plan par programmation
La propriété Plan permet de :
  • connaître et changer le plan actif d'une fenêtre ou d'un état.
  • connaître et changer le plan associé à un champ.

Changer de plan dans une fenêtre

Le changement de plan dans une fenêtre peut être réalisé à tout moment. Souvent, un bouton permet de changer de plan.
Exemple :
// Passage sur le plan 4 ajout de commande
FEN_CRM.Plan = 4
Le changement de plan est immédiat : seuls les champs associés au plan sont affichés.
Remarque : Si les plans ont été nommés sous l'éditeur de fenêtres, il est possible d'utiliser le nom du plan au lieu du numéro du plan.

Changer de plan dans un état

Le changement de plan dans un état doit être fait pendant l'impression de l'état. Il est conseillé d'utiliser la propriété Plan dans un des événements associés à l'état, aux blocs ou aux champs.
// Ouverture de l'état
// Affichage du plan 2
MonEtat.Plan = 2
Le changement de plan est immédiat : seuls les champs associés au plan sont imprimés.
Remarque : Remplacer les blocs de substitution par les plans :
Jusqu'en version 18, les blocs de substitution permettaient de remplacer un bloc par un autre durant l'impression. Cependant, pour éviter les problèmes d'impression, il était recommandé de créer des blocs de substitution de même hauteur que le bloc à remplacer.
A partir de la version 19, les plans peuvent facilement remplacer un bloc de substitution. En effet, il suffit :
  • sous l'éditeur : de positionner les champs du bloc de substitution dans le bloc voulu et de les affecter à un plan.
  • par programmation : de remplacer l'appel à la fonction iSubstBloc par l'appel à la propriété Plan pour afficher le plan voulu.
Liste des exemples associés :
WD Assistant Exemples didactiques (WINDEV) : WD Assistant
[ + ] Cet exemple illustre la réalisation d'une fenêtre "Assistant" avec les fonctions WLangage.
Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ la gestion des plans
2/ la modification dynamique d'un libellé

Résumé de l'exemple livré avec WINDEV :
Cet exemple montre comment gérer facilement un "Assistant" dans une même fenêtre grâce au concept de plans. L'utilisateur est guidé étape par étape en cliquant sur les boutons "Suivant", "Précédent" et "Terminer"
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 02/06/2023

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