DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés des fenêtres, des pages et de leurs champs
  • Plan et fenêtre
  • Plan et fenêtre interne
  • Plan et champ Cellule
  • Plan et état interne
  • Limites
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
La propriété Plan permet de :
  • Connaître le plan actif d'une fenêtre (ou d'un état) ou le plan auquel appartient un champ.
  • Modifier le plan actif d'une fenêtre (ou d'un état) ou associer un champ à un autre plan.
Remarques :
  • Un plan est une "couche" :
    • d'une fenêtre,
    • d'un état.
    Il est impossible de visualiser plusieurs plans simultanément (sous l'éditeur de fenêtres, de pages, d'états ou dans vos applications).
  • Dans une fenêtre ou un état, chaque champ peut :
    • n'appartenir à aucun plan. Ce champ sera toujours affiché, quel que soit le plan en cours.
    • appartenir à un plan. Ce champ ne sera affiché que lorsque le plan correspondant sera visible.
    • appartenir à plusieurs plans. Ce champ sera affiché lorsque un des plans associés au champ sera actif (c'est-à-dire visible).
  • 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.
Exemple
Universal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOS
// Modification du plan actif
FEN_FenêtreSaisie.Plan = 2
Syntaxe

Connaître le plan actif d'une fenêtre (ou d'un état) ou le plan auquel appartient un champ Masquer les détails

<Numéro du plan> = <Elément manipulé>.Plan
<Numéro du plan> : Entier ou chaîne de caractères
  • Numéro du plan actif de la fenêtre spécifiée.
  • Numéro du plan actif de l'état spécifié.
  • Numéro du plan auquel appartient le champ spécifié.
  • Numéros des plans (séparés par une virgule) auxquels le champ appartient.
<Elément manipulé> : Nom de champ, de fenêtre ou d'état
Nom de l'élément à manipuler :
  • Nom du champ.
  • Nom de la fenêtre.
  • Nom de l'état.

Modifier le plan actif d'une fenêtre (ou d'un état) ou associer un champ à un autre plan Masquer les détails

<Elément manipulé>.Plan = <Nouveau plan>
<Elément manipulé> : Nom de champ, de fenêtre ou d'état
Nom de l'élément à manipuler :
  • Nom du champ.
  • Nom de la fenêtre.
  • Nom de l'état.
<Nouveau plan> : Entier ou chaîne de caractères
  • Numéro du plan à activer. Si ce numéro est supérieur au nombre de plans existants, seuls les champs non affectés à un plan seront affichés.
  • Numéro du plan associé au champ spécifié. Si ce numéro ne correspond pas au plan en cours, le champ ne sera plus affiché.
  • Numéros des plans associés au champ. Ces numéros sont fournis sous forme d'une chaîne de caractères et séparés par une virgule.
  • WINDEV Mobile Nom du plan à activer (uniquement pour les fenêtres). Le nom du plan a été défini dans la fenêtre de gestion des plans sous l'éditeur de fenêtres.
Remarques
Universal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOS

Plan et fenêtre

  • Si un champ n'est pas affecté à un plan (option <Aucun> sélectionnée dans la fenêtre de description), ce champ est affiché quel que soit le plan actif de la fenêtre ou de l'état.
  • Si un champ est affecté à un plan, ce champ est affiché uniquement s'il appartient au plan actif de la fenêtre ou de l'état.
  • Si un champ est affecté à plusieurs plans, ce champ sera affiché dès que un de ces plans sera actif (c'est-à-dire visible).
  • A l'ouverture d'une fenêtre ou d'un état, le plan actif est le plan numéro 0.
AndroidiPhone/iPad

Plan et fenêtre interne

La propriété Plan peut être utilisée :
  • directement sur la fenêtre interne. Dans ce cas, cette propriété manipule les champs de la fenêtre interne.
    Par exemple, pour afficher le plan 2 de la fenêtre interne depuis la fenêtre hôte ou directement dans la fenêtre interne, il faut utiliser la ligne de code :
    <Nom de la fenêtre interne>.Plan = 2
  • directement sur la fenêtre hôte (accueillant le champ Fenêtre interne). Dans ce cas, cette propriété s'appliquera uniquement à tous les champs de la fenêtre hôte (y compris au champ Fenêtre interne s'il est associé à un plan). Le contenu de la fenêtre interne ne sera pas modifié. La ligne de code utilisée sera :
    <Nom de la fenêtre>.Plan = 2
Nouveauté 2024
La propriété PlanActif peut également être utilisée. Son fonctionnement est identique.
Nouveauté 2024
iPhone/iPad

Plan et champ Cellule

La propriété Plan peut être utilisée sur le champ Cellule. Dans ce cas, elle permet de connaître et de modifier le plan auquel appartient le champ Cellule dans son parent (fenêtre ou fenêtre interne).
Par exemple, pour afficher le champ Cellule sur le plan 2 de la fenêtre, il faut utiliser la ligne de code :
<Nom du champ Cellule>.Plan = 2
Pour connaître et modifier le plan actif dans le champ Cellule, il est nécessaire d'utiliser la propriété PlanActif.
Par exemple, pour afficher le plan 2 du champ Cellule, il faut utiliser la ligne de code :
<Nom du champ Cellule>.PlanActif = 2

Plan et état interne

La propriété Plan peut être utilisée :
  • directement sur l'état interne. Dans ce cas, cette propriété manipule les champs de l'état interne.
    Par exemple, pour afficher le plan 2 de l'état interne depuis l'état hôte ou directement dans l'état interne, il faut utiliser la ligne de code :
    <Nom de l'état interne>.Plan = 2
  • directement sur l'état hôte (accueillant le champ Etat interne). Dans ce cas, cette propriété s'appliquera uniquement à tous les champs de l'état hôte (y compris au champ état interne s'il est associé à un plan). Le contenu de l'état interne ne sera pas modifié. La ligne de code utilisée sera :
    <Nom de l'état>.Plan = 2

Limites

La propriété Plan ne peut pas être utilisée sur :
  • une option d'un champ Interrupteur ou Sélecteur,
  • une ligne d'un champ Table, Liste ou Combo,
  • une cellule d'un champ Table,
  • une colonne d'un champ Table,
  • un menu de fenêtre,
  • un volet d'onglet,
  • un groupe de champs,
Widget Android La propriété Plan s'applique uniquement aux éléments suivants :
  • Champ Bouton.
  • Champ Libellé.
  • Champ Image.
  • Fenêtre.
Universal Windows 10 AppiPhone/iPadWidget IOS La propriété Plan n'est pas disponible sur les états.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/02/2024

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