DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Modèle de fenêtres
  • Présentation
  • Création d'un modèle de fenêtres
  • Créer un modèle de fenêtres
  • Créer un modèle de fenêtres à partir d'une fenêtre existante
  • Appliquer un modèle de fenêtres
  • Créer une nouvelle fenêtre basée sur un modèle de fenêtres
  • Appliquer un modèle sur une fenêtre existante
  • Remarques
  • Ouvrir le modèle associé à une fenêtre
  • Reporter les modifications effectuées sur un modèle
  • Tester un modèle de fenêtres
  • Liste des modèles utilisés
  • Synchronisation des fenêtres et des modèles de fenêtres
  • Exemple
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
WINDEV et WINDEV Mobile permettent de créer des modèles de fenêtres. Ces modèles contiennent tous les éléments graphiques et le code communs à l'ensemble des fenêtres de votre application.
Les modifications effectuées dans un modèle de fenêtres sont automatiquement reportées sur toutes les fenêtres utilisant ce modèle.
Un modèle de fenêtres permet de respecter la charte graphique définie pour une application.
L'utilisation de modèles de fenêtres dans vos applications permet de :
  • simplifier la création des fenêtres de l'application.
  • simplifier la mise en page des fenêtres de l'application.
  • simplifier la mise à jour de la charte graphique de l'application.
Création d'un modèle de fenêtres
Un modèle de fenêtres peut être créé :
  • soit directement, comme une nouvelle fenêtre.
  • soit à partir d'une fenêtre existante.

Créer un modèle de fenêtres

Pour créer un modèle de fenêtres :
  1. Créez un nouveau modèle de fenêtres :
    • Cliquez sur parmi les boutons d'accès rapide.
    • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Fenêtre" puis sur "Modèle de fenêtres".
  2. Vous pouvez :
    • Créer un modèle de fenêtres vierge (basé ou non sur le gabarit utilisé par le projet),
    • Créer un modèle de fenêtres vierge basé sur un gabarit différent de celui du projet,
    • Si votre projet utilise déjà des modèles de fenêtres, créer un modèle de fenêtres basé sur un autre modèle de fenêtres du projet. Dans ce cas, les mises à jour des modèles de fenêtres seront effectuées en cascade.
  3. L'éditeur de fenêtres affiche une nouvelle fenêtre dans un cadre orange intitulé "Modèle de fenêtres".
  4. Créez tous les champs nécessaires. Ces champs seront présents sur toutes les fenêtres utilisant le modèle.
  5. Saisissez si nécessaire le code WLangage correspondant :
    • aux événements associés à la fenêtre.
    • aux événements associés aux différents champs du modèle.
      Ces événements et leur code WLangage seront automatiquement importés dans les fenêtres utilisant le modèle.
  6. Donnez un nom à votre modèle (onglet "Général" de la fenêtre de description).
  7. Sous le volet "Accueil", dans le groupe "Général", cliquez sur "Enregistrer" (ou cliquez sur parmi les boutons d'accès rapide).
Le modèle de fenêtres correspond à un fichier d'extension ".WDT".

Créer un modèle de fenêtres à partir d'une fenêtre existante

Pour créer un modèle de fenêtres à partir d'une fenêtre existante :
  1. Ouvrez la fenêtre choisie comme modèle.
  2. Conservez uniquement les champs nécessaires au modèle. Ces champs seront présents sur toutes les fenêtres utilisant le modèle de fenêtres.
  3. Conservez uniquement le code des événements nécessaires au modèle. Ces événements seront automatiquement importés dans les fenêtres utilisant le modèle.
  4. Donnez un nom à votre fenêtre (onglet "Général" de la fenêtre de description de la fenêtre).
  5. Sous le volet "Accueil", dans le groupe "Général", cliquez sur "Enregistrer" et sélectionnez "Enregistrer comme un modèle". La fenêtre en cours devient un modèle :
    • son nom est précédé de "Modèle".
    • un cadre orange entoure la fenêtre dans l'éditeur de fenêtres.
    • le modèle de fenêtres apparaît dans le volet "Explorateur de projet" dans le dossier "Modèles de fenêtres".
Le modèle de fenêtres correspond à un fichier d'extension ".WDT".
Appliquer un modèle de fenêtres

Créer une nouvelle fenêtre basée sur un modèle de fenêtres

Pour créer une nouvelle fenêtre basée sur un modèle de fenêtres :
  1. Créez une nouvelle fenêtre :
    • Cliquez sur parmi les boutons d'accès rapide.
    • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Fenêtre" puis sur "Fenêtre".
  2. Sélectionnez le volet "Basée sur un Modèle" dans l'assistant qui s'affiche.
  3. Choisissez votre modèle dans la liste des modèles disponibles.
  4. Validez. La nouvelle fenêtre apparaît sous l'éditeur.
Un carré jaune permet d'identifier les éléments appartenant au modèle de fenêtres. Ces éléments pourront être modifiés :
  • dans le modèle de fenêtres : la modification sera effective pour toutes les fenêtres utilisant ce modèle.
  • dans la fenêtre, par le mécanisme de "surcharge de champs" : la modification sera effective uniquement pour la fenêtre.

Appliquer un modèle sur une fenêtre existante

Pour appliquer un modèle sur une fenêtre existante :
  1. Affichez la fenêtre sous l'éditeur de fenêtres.
  2. Sous le volet "Fenêtre", dans le groupe "Modèles", déroulez "Modèles" et sélectionnez "Hériter d'un modèle".
  3. Sélectionnez le modèle de fenêtres à appliquer.
  4. Validez.
  5. Indiquez si vous souhaitez mettre à jour les propriétés de la fenêtre depuis le modèle.
    Si vous répondez "Oui", la liste des propriétés à surcharger apparaît. Dans cette fenêtre, vous pouvez sélectionner les propriétés de la fenêtre initiale à conserver. Le modèle de fenêtres appliqué sera automatiquement surchargé pour les propriétés conservées. Pour toutes les autres caractéristiques, la fenêtre sera automatiquement liée au modèle.
  6. Validez.
Remarque : Par défaut, les caractéristiques de taille ainsi que le titre de la fenêtre sont automatiquement surchargés.

Remarques

  • Il est possible d'appliquer plusieurs modèles à une fenêtre. Dans ce cas, les champs des différents modèles sont présents dans la fenêtre, ainsi que les différents traitements de chacun des modèles. Les propriétés de la fenêtre (dimensions, cadre, ...) ne peuvent être liées qu'à un seul modèle.
  • Certains gabarits utilisent des champs de "décor" (par exemple le gabarit ActiveVista). Ces champs permettent d'afficher le titre de la fenêtre, les boutons système, ... Ces champs de décor sont considérés comme étant des propriétés de la fenêtre.
  • Dans cette version :
    • les menus du modèle ne sont pas appliqués dans la fenêtre utilisant le modèle.
    • Android l'action bar du modèle n'est pas appliqué dans la fenêtre utilisant le modèle.
  • La surcharge au niveau des barres de messages n'est pas gérée.
  • La surcharge de styles au niveau des modèles est gérée.
  • Il est également possible d'appliquer un modèle de fenêtres sur une fenêtre interne existante. Pour plus de détails, consultez Champ Fenêtre interne.
Ouvrir le modèle associé à une fenêtre
Pour ouvrir le modèle associé à une fenêtre :
  1. Affichez la fenêtre sous l'éditeur de fenêtres.
  2. Dans le menu contextuel d'un élément du modèle, sélectionnez l'option "Ouvrir le modèle".
Autre possibilité :
  • Listez les modèles associés à la fenêtre : sous le volet "Fenêtre", dans le groupe "Modèles", déroulez "Modèles" et sélectionnez "Liste des modèles utilisés".
  • Sélectionnez le modèle voulu et cliquez sur le bouton "Ouvrir le modèle".
Reporter les modifications effectuées sur un modèle
Lors de la modification d'un modèle de fenêtres, il est possible de reporter les modifications effectuées sur une ou plusieurs fenêtres utilisant ce modèle dans le projet en cours.
Ce report des modifications est proposé à la fermeture du modèle.
Il peut également être effectué à tout moment :
  • depuis le modèle : sous le volet "Fenêtre", dans le groupe "Modèles", déroulez "Modèles" et sélectionnez "Mettre à jour les fenêtres associées".
  • depuis n'importe quelle fenêtre utilisant le modèle :
    • en ouvrant la liste des modèles utilisés : sous le volet "Fenêtre", dans le groupe "Modèles", déroulez "Modèles" et sélectionnez "Liste des modèles utilisés".
    • puis en cliquant sur le bouton "Se mettre à jour".
  • directement depuis le modèle de fenêtres, en cliquant sur l'icône dans le bandeau orange du modèle.
Remarque : Le report des modifications du modèle est effectué en fonction des caractéristiques surchargées dans les fenêtres qui utilisent le modèle.
Tester un modèle de fenêtres
Pour tester un modèle de fenêtres :
  1. Ouvrez le modèle à tester :
    • Sous le volet "Fenêtre", dans le groupe "Modèles", déroulez "Modèles" et sélectionnez "Liste des modèles utilisés",
    • Cliquez sur le bouton "Ouvrir le modèle".
  2. Cliquez sur le bouton parmi les boutons d'accès rapide.
Liste des modèles utilisés
Pour afficher la liste des modèles utilisés pour une fenêtre, sous le volet "Fenêtre", dans le groupe "Modèles", déroulez "Modèles" et sélectionnez "Liste des modèles utilisés".
Depuis cette fenêtre, il est possible de :
  • "Ouvrir un modèle" : ouvre le modèle sélectionné dans l'éditeur de fenêtres.
  • "Se mettre à jour" : les champs et le code du modèle sont mis à jour dans la fenêtre.
  • "Ajouter" : ajoute un modèle à la fenêtre en cours.
  • "Dissocier" : les champs du modèle présents dans la fenêtre sont dissociés du modèle. Le modèle est supprimé de la liste des modèles utilisés, mais ses champs ne sont pas supprimés de la fenêtre.
  • "Supprimer" : supprime le modèle (champs et code) de la fenêtre.
Synchronisation des fenêtres et des modèles de fenêtres
Il est possible de synchroniser les fenêtres et leurs modèles :
  • lors de la création d'exécutables, de composants, ... Il suffit de cocher l'option "Synchroniser les modèles lors de la génération" (onglet "Options" de la description du projet).
  • lors du GO du projet. La mise à jour des fenêtres en fonction des modèles de fenêtres est automatiquement proposée.
Exemple
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 15/09/2023

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