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
  • 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
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.
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