DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Modèle de pages
  • Présentation
  • Principe de l'héritage et de la surcharge
  • Surcharge des pages
  • Surcharger les propriétés des pages
  • Surcharger le code des pages
  • Surcharge des champs
  • Surcharger le look d'un champ (surcharge d'IHM)
  • Surcharger le code d'un champ (surcharge de code)
  • Remarques
  • Gérer les propriétés surchargées d'un champ
  • Connaître les propriétés surchargées
  • Surcharge des procédures locales
  • Surcharger le code d'une procédure locale
  • Limitations
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
Modèles de pages et héritage
Présentation

Principe de l'héritage et de la surcharge

Lorsque vous appliquez un modèle de pages à une page, l'ensemble des champs et du code du modèle sont "copiés" dans la page. C'est le concept d'héritage.
Les champs du modèle sont visibles dans la page, sous l'éditeur de pages. Un carré jaune est situé dans le coin haut gauche de chaque champ. Par défaut, les champs du modèle ne sont pas modifiables.
Le code du modèle est visible dans l'éditeur de code, dans les différents événements de la page ou de ses champs. Ce code WLangage est facilement identifiable :
  • les événements associés au modèle sont suivis de "(modèle <Nom du modèle>)" (par exemple : "Clic sur le bouton Valider (modèle MonModèle)").
  • le fond des événements est grisé car le code n'est pas modifiable.
Dans le cas de modèle de modèles, l'héritage se fait sur plusieurs niveaux.
Il est possible de surcharger les champs et le code du modèle. La surcharge des champs et du code permet de modifier, pour une page donnée, le code et / ou les champs du modèle.
Surcharge des pages

Surcharger les propriétés des pages

Surcharger les propriétés des pages modèle consiste à modifier les caractéristiques de la page utilisant le modèle (par exemple les caractéristiques affichées dans la fenêtre de description).
Dès qu'une caractéristique de la page utilisant le modèle est modifiée, cette propriété est surchargée.
Remarque : Les propriétés de la page surchargeables sont les suivantes : Image, Image de fond fixe, Couleur de fond, Couleur du texte, Couleur de lien, Couleur du lien visité, Couleur du lien actif, Lien souligné, Centrer la page, Fixer les champs dans la page, Titre, Champ pour afficher la jauge, Position de jauge AJAX. Il est également possible de surcharger le menu d'un modèle.

Surcharger le code des pages

Pour surcharger le code des pages modèle :
  1. Affichez les événements de la page (option "Code" du menu contextuel).
  2. Si un événement existe dans la page modèle, cet événement apparaît en double dans la page utilisant le modèle. En effet, sont affichés :
    • l'événement issu du modèle. Cet événement apparaît en grisé et son intitulé est suivi de "(modèle <Nom du modèle>)".
    • l'événement de la page.
  3. Le code saisi dans l'événement de la page sera exécuté de la manière suivante :
    • l'événement de déclaration des globales est fusionné entre le modèle et la page utilisant le modèle. Il est donc nécessaire de ne pas utiliser des variables de même nom dans cet événement.
    • pour tous les événements (sauf celui de fermeture de la page) : les événements des modèles appliqués à la page sont exécutés en suivant leur ordre d'inclusion, puis l'événement correspondant à la page est exécuté.
    • pour l'événement de fermeture de la page : l'événement de fermeture de la page est exécuté, puis les événements des modèles appliqués à la page sont exécutés en suivant l'ordre inverse d'inclusion.
Surcharge des champs

Surcharger le look d'un champ (surcharge d'IHM)

Pour surcharger l'interface d'un champ du modèle (un bouton par exemple) :
  1. Affichez le menu contextuel d'un bouton du modèle présent dans la page.
  2. Sélectionnez l'option "Surcharger le champ".
  3. Le carré jaune a été remplacé par un carré bleu, indiquant que ce champ peut être surchargé.
  4. Vous pouvez maintenant modifier tous les aspects de l'interface du bouton : dimensions, position, style, ...

Surcharger le code d'un champ (surcharge de code)

Pour surcharger le code d'un champ du modèle (code d'un bouton par exemple) :
  1. Affichez le menu contextuel d'un bouton du modèle présent dans la fenêtre.
  2. Sélectionnez l'option "Surcharger le champ".
  3. Le carré jaune a été remplacé par un carré bleu, indiquant que ce champ peut être surchargé.
  4. Affichez le code du bouton (option "Code" du menu contextuel).
  5. Deux sections de code de clic sont présents :
    • le code de clic issu du modèle.
    • le code de clic de la page. Une fonction a été automatiquement ajoutée : ExécuteAncêtre. Cette fonction exécute le code de clic du modèle.
  6. Ajoutez le code du bouton spécifique à la page en cours, avant et/ou après la procédure d'appel au code du modèle. Vous pouvez supprimer la fonction ExécuteAncêtre si vous ne souhaitez pas que le code du modèle soit exécuté.

Remarques

  • Il n'est pas possible de supprimer un bouton surchargé d'un modèle.
  • La surcharge d'une table surchage également les colonnes. Il est possible d'ajouter des colonnes dans une table héritée.
  • La surcharge des styles n'est pas disponible. Cependant, il est possible de surcharger le style du champ.
Gérer les propriétés surchargées d'un champ

Connaître les propriétés surchargées

Pour connaître les propriétés d'un champ qui ont été surchargées :
  1. Ouvrez le menu contextuel du champ.
  2. Sélectionnez l'option "Propriétés surchargées".
  3. La fenêtre de gestion des surcharges s'ouvre.
Il est possible depuis cette fenêtre de supprimer les propriétés surchargées. Il suffit de sélectionner la propriété voulue et de la supprimer.
Pour supprimer complètement toutes les surcharges effectuées sur un champ, il suffit de sélectionner la ligne intitulée "Surcharge complète".
Surcharge des procédures locales

Surcharger le code d'une procédure locale

Pour surcharger le code d'une procédure locale depuis de volet "Explorateur de projet" :
  1. Sélectionnez l'élément associé à la procédure locale (fenêtre, page, état, ...).
  2. Déroulez les options de l'élément et sélectionnez l'option "Procédures locales" de l'élément.
  3. Sélectionnez la procédure à surcharger.
  4. Affichez le menu contextuel et sélectionnez l'option "Surcharger le code de la procédure locale".
  5. Deux sections de code de clic sont présents :
    Surcharge de procédure locale
    • le code de la procédure issu du modèle.
    • le code de la nouvelle procédure. Une fonction a été automatiquement ajoutée : ExécuteAncêtre. Cette fonction exécute le code de la procédure du modèle.
  6. Ajoutez le code de la nouvelle procédure spécifique à l'élément en cours, avant et/ou après la procédure d'appel au code du modèle. Vous pouvez supprimer la fonction ExécuteAncêtre si vous ne souhaitez pas que le code du modèle soit exécuté.
Limitations
  • Il n'est pas possible d'utiliser une requête intégrée dans un champ du modèle. L'exécution de la page utilisant le modèle provoquera une erreur.
  • La surcharge de style n'est pas disponible.
Version minimum requise
  • Version 11
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 14/06/2023

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