Appliquer un gabarit à un projet

Pour appliquer un gabarit à un projet :

1. Sous le volet "Projet", dans le groupe "Autres actions", cliquez sur "Appliquer un gabarit au projet".
2. Sélectionnez le gabarit à appliquer.
3. Par défaut :
   • le gabarit sélectionné sera appliqué sur :
     • l'ensemble des fenêtres et des états du projet.
     • l'ensemble des champs des fenêtres et des états.
   • les champs utilisés uniquement pour l'interface des fenêtres (champs décors servant par exemple à réduire ou fermer la fenêtre) seront supprimés et remplacés par ceux du nouveau gabarit.
   • le gabarit sélectionné est appliqué en se basant sur le nom des styles. Tous les noms de style dans les gabarits fournis sont standard. Cette option permet d'optimiser l'application du gabarit. Les surcharges de style, si elles existent sont conservées.

• Cette méthode peut être appliquée à un projet utilisant ou non un gabarit.
• Il est également possible d'associer un gabarit à un projet (option "Gabarit du projet" dans l'onglet "Style" de la description du projet). Le gabarit sélectionné sera proposé par défaut lors de la création d'une fenêtre ou d'un état.

Appliquer un gabarit à une fenêtre

Pour appliquer un gabarit à une fenêtre :

1. Sous le volet "Fenêtre", dans le groupe "Style et gabarits", cliquez sur "Appliquer un gabarit".
2. Sélectionnez le gabarit à appliquer. Le gabarit sélectionné est automatiquement appliqué à la fenêtre ouverte sous l'éditeur. Il est ainsi possible de voir directement l'effet du gabarit.
3. Par défaut :
   • le gabarit sélectionné sera appliqué sur :
     • la fenêtre en cours.
     • l'ensemble des champs de la fenêtre en cours (qu'ils utilisent ou non un gabarit).
   • les champs utilisés uniquement pour l'interface de la fenêtre (champs décors servant par exemple à réduire ou fermer la fenêtre) seront supprimés et remplacés par ceux du nouveau gabarit.
   • le gabarit sélectionné est appliqué en se basant sur le nom des styles. Tous les noms de style dans les gabarits fournis sont standard. Cette option permet d'optimiser l'application du gabarit. Les surcharges de style, si elles existent, sont conservées.
4. Selon l'aperçu, vous pouvez :
   • Valider le gabarit sélectionné : le gabarit sera alors réellement appliqué à la fenêtre en cours.
   • Changer de gabarit. Le nouveau gabarit sélectionné est automatiquement appliqué en visualisation à la fenêtre en cours.
   • Annuler le changement de gabarit. La fenêtre en cours sous l'éditeur reprend son aspect initial.

Créer un gabarit de fenêtre

Si aucun gabarit fourni par défaut ne vous convient, vous pouvez créer votre propre gabarit.

• Étape 1 : Création d'un projet regroupant les différents gabarits de fenêtre.
• Étape 2 : Création d'une fenêtre contenant les styles des champs.
• Étape 3 : Création d'une fenêtre modèle.
• Étape 4 : Génération du gabarit.
• Étape 5 (optionnelle) : Création de l'aperçu du gabarit.

Modifier un gabarit de fenêtre

Pour modifier un gabarit existant, il suffit de modifier le fichier gabarit (fichier .STY) présent dans le répertoire où le gabarit a été généré.

Créer un gabarit d'état

Si aucun gabarit fourni par défaut ne vous convient, vous pouvez créer votre propre gabarit.

• Étape 1 : Création d'un projet regroupant les différents gabarits d'état.
• Étape 2 : Création d'un état gabarit pour tous les types d'états.
• Étape 3 : Copie des états gabarit.
• Étape 4 (optionnelle) : Création d'un aperçu d'état.

• Nous vous indiquons ici une des méthodes de création d'un gabarit d'états. La marche à suivre décrite ci-dessus est conseillée mais en aucun cas obligatoire.
• La création de gabarits d'états n'est pas disponible sous le logiciel Etats & Requêtes.

Supprimer un gabarit

Pour supprimer un gabarit d'un projet, il faut supprimer le gabarit de toutes les fenêtres du projet :

1. Affichez la fenêtre de description du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
2. Dans l'onglet "Style", choisissez le gabarit "Aucun".
3. Pour chaque fenêtre du projet :
   • Ouvrez la fenêtre sous l'éditeur.
   • Affichez la description de la fenêtre (option "Description" du menu contextuel).
   • Dans l'onglet "Style", sélectionnez le gabarit "Aucun".
   • Validez la fenêtre de description.
   • Dans la fenêtre, modifiez le style des champs pour qu'ils n'utilisent plus le gabarit (il est possible de s'aider du bouton "Style utilisé" de l'onglet "Style" de la fenêtre de description des champs).
4. Lorsque toutes les fenêtres ont été traitées, sous le volet "Projet", dans le groupe "Projet", déroulez "Recompiler et synchroniser" et sélectionnez l'option "Réactualiser style et gabarit". Si aucun lien n'est trouvé entre les champs et le gabarit, le gabarit sera automatiquement supprimé du projet.

Présentation

Appliquer un gabarit dynamiquement à des fenêtres consiste à appliquer un gabarit uniquement en exécution, lors de l'affichage de la fenêtre. Cette fonctionnalité permet ainsi d'harmoniser rapidement des fenêtres provenant par exemple de plusieurs applications.

Comment le faire ?

Pour appliquer dynamiquement un gabarit aux différentes fenêtres de votre application (ou uniquement aux fenêtres de vos composants WINDEV), il suffit d'utiliser la fonction ChangeGabarit (par exemple dans le code d'initialisation du projet), en indiquant :

• le champ d'application du nouveau gabarit (fenêtre spécifique, fenêtres des composants, toutes les fenêtres)
• le nom du gabarit à utiliser. Ce nom correspond à un fichier "WDY", généré lors de la création du gabarit. Ce fichier doit être livré avec l'application.

Fichiers nécessaires

Pour appliquer un gabarit dynamiquement à une ou plusieurs fenêtres, il est nécessaire de fournir lors du déploiement de l'application :

• l'application et si nécessaire ses composants WINDEV associés.
• le ou les fichiers WDY correspondants aux différents gabarits à appliquer. Ces fichiers peuvent être incorporés à la bibliothèque de l'application (fichier WDL). Pour plus de détails, consultez Créer un exécutable.