WINDEV 2025 : Les concepts

80 Partie 2 : Environnement de développement Remarque  : A chaque re-génération du composant, il est possible de re-générer la documentation asso- ciée au composant (bouton "Regénérer"). Attention  : Si vous utilisez le bouton "Regénérer", les modifications de la documentation effectuées dans l’assistant de génération seront supprimées. Comment disposer de la documentation d’un com- posant ? La présentation générale du composant est auto- matiquement affichée dans la fenêtre de descrip- tion du composant. La documentation technique du composant est disponible : • lors de l’intégration d’un composant dans un pro- jet : sous le volet "Projet", dans le groupe "Projet", déroulez "Importer" et sélectionnez "Un compo- sant externe". • à tout moment, dans la description des compo- sants intégrés dans le projet. Dans le volet "Explorateur de projet" : • Dans le dossier "Composants externes", sélec- tionnez le composant externe voulu. • Affichez le menu contextuel (clic droit) et sélectionnez l’option "Description". • L’onglet "Détail" permet d’obtenir le détail de la documentation générée. La documentation spécifique à un élément du com- posant (fenêtre, ...) peut être obtenue : • soit en double-cliquant sur cet élément depuis le volet "Explorateur de projet" ou en appuyant sur la touche F2 depuis le code de cet élément. • soit depuis le volet "Explorateur de projet" : • Sélectionnez le dossier "Composants ex- ternes". • Affichez le menu contextuel (clic droit). • Sélectionnez l’option "Liste des composants externes importés dans le projet". 7.2 Visibilité d’un élément d’un composant Lors de la création d’un composant, il est possible de définir les éléments du composant qui seront acces- sibles ou non par l’utilisateur du composant. • Si l’élément est accessible, l’utilisateur du compo- sant verra cet élément dans la liste des éléments du projet. Il pourra manipuler ces éléments par programmation (comme s’il s’agissait d’un élé- ment créé dans le projet). Remarque  : Le code de cet élément n’est cepen- dant pas visible. • Si l’élément n’est pas accessible, l’utilisateur ne saura même pas que cet élément existe. Attention  : Selon le mode de déclaration des élé- ments du projet (classe, collection de procédures, etc.), les éléments accessibles ou non peuvent varier. 7.3 Le fichier WDO Lors de la génération du composant externe, plu- sieurs fichiers sont automatiquement créés dans le répertoire EXE du projet en cours : • <NomComposant>.WDK Contient tous les éléments à redistribuer (fenêtres, états, ...) avec le composant. • <NomComposant>.WDI Interface du composant. Ce fichier contient : • une aide pour l’utilisation du compo- sant lors de sa réintégration. • les éléments à l’utilisation du com- posant dans le projet (information de compilation...). • <NomComposant>.WDZ Fichier contenant les dépendances du fi- chier WDK (uniquement pour les compo- sants WEBDEV et WINDEV Mobile). Ces informations sont extraites dans le projet dans lequel le composant est intégré. Lors de la diffusion du composant externe, ces fichiers doivent être redistribués. Si le composant externe utilise des éléments sup- plémentaires (fichiers de données par exemple), il est nécessaire d’ajouter dans le répertoire EXE du projet : • un fichier <Nom du composant>.WDO : Ce fichier contient la liste des fichiers externes (fichiers de données, fichiers texte, etc.) utilisés par le com- posant externe. Ces fichiers doivent être livrés et installés avec le composant externe. • les fichiers devant être redistribués avec le com- posant externe. Ces fichiers peuvent être placés selon une sous arborescence spécifique. Dans ce cas, le code du composant externe doit gérer l’accès à ces fichiers selon cette même arbores- cence.