WINDEV 2025 : Les concepts

72 Partie 2 : Environnement de développement Composant interne en pratique 1 Présentation Un composant interne est un regroupement d’élé- ments d’un projet. Ce regroupement permet de : • Organiser un projet  : Vous pouvez créer des com- posants internes pour regrouper les éléments d’un projet par exemple par fonctionnalité. • Partager des éléments entre différents pro- jets  : Les éléments présents dans un composant interne peuvent être partagés entre plusieurs projets par l’intermédiaire du GDS. Un des avantages du composant interne par rapport au composant externe est de pouvoir déboguer di- rectement le composant interne depuis le projet qui l’utilise. Différence avec un composant externe  : Un com- posant interne permet d’intégrer la totalité des éléments du composant dans l’interface du projet contenant le composant interne. Il est possible de manipuler tous les éléments "publics" du compo- sant interne directement sous l’éditeur. Lors de l’utilisation d’un composant externe, les éléments "publics" du composant ne peuvent pas être manipulés directement. Il est nécessaire pour modifier le composant externe d’ouvrir le projet correspondant. 2 Créer un composant interne 2.1 Les différentes étapes Pour créer un composant interne  : 1. Sous le volet "Projet", dans le groupe "Configura- tion de projet", déroulez "Nouvelle configuration" et sélectionnez l’option "Composant Interne". L’assis- tant création d’un composant interne se lance. 2.  Indiquez les caractéristiques du composant interne : • son nom. Le nom du composant interne sera utilisé pour le fichier WCI correspondant à la description du composant interne. Ce nom sera également utilisé pour créer un sous-ré- pertoire dans votre projet contenant tous les éléments du composant interne. • son libellé. • sa description. 3.  Indiquez les éléments à intégrer dans le compo- sant interne. Un composant interne peut contenir tous les types d’éléments présents dans un projet : fenêtres, états, modèles, collections de procé- dures, etc. 4.  Indiquez les éléments du composant interne qui seront directement accessibles dans le code et dans les actions prédéfinies du projet accueillant le composant interne. Remarque  : Les éléments du composant interne ac- cessibles (ou "public") seront automatiquement pro- posés par la complétion. Ils pourront être utilisés par les éléments présents dans le projet ou depuis un autre composant interne. Les éléments non acces- sibles (ou "privés") pourront être manipulés unique- ment par un autre élément du composant interne (la complétion proposera ces éléments "privés" unique- ment depuis les éléments d’un composant interne). 5.  Indiquez le mode de gestion des données et des contextes d’exécution. Trois modes de gestion des données et des contextes d’exécution sont dispo- nibles : • Utiliser l’analyse du projet ou aucune analyse (partage complet)  : Le composant interne accède aux fichiers de données du projet. Le composant interne utilise également les mêmes contextes d’exécution que le projet. Ce mode correspond au mode par défaut si le composant interne n’utilise pas d’analyse. • Utiliser l’analyse du projet avec contexte d’exécution différent (mode avancé)  : Le com- posant interne accède aux fichiers de données du projet. Le composant interne utilise des contextes d’exécution distincts de ceux du projet. Ce mode est à utiliser dans des cas très spé- cifiques.