WINDEV 2025 : Les concepts

Partie 2 : Environnement de développement 75 Composant externe en pratique 1 Présentation 1.1 Définition Un composant externe est un ensemble d’éléments WINDEV, WEBDEV ou WINDEV Mobile : fenêtres, pages, états, analyse, etc. Cet ensemble d’éléments effectue une fonctionnalité précise. Par exemple, un composant peut correspondre à une des fonction- nalités suivantes : • Envoi de fax, • Envoi d’emails, • etc. Remarques  : • Pour optimiser l’organisation de vos projets, il est possible d’utiliser des composants internes. Pour plus de détails, consultez "Composant interne en pratique", page 72. • Dans la suite de ce chapitre, le terme "compo- sant" signifie "composant externe". Un composant externe peut être redistribué à d’autres développeurs WINDEV, WEBDEV ou WINDEVMobile (gratuitement ou non). Ces déve- loppeurs pourront ainsi intégrer simplement la fonctionnalité proposée par le composant dans leur application (ou leur site). Le composant sera donc intégré à l’application (ou site), et distribué avec l’application (ou site). Lors de la création du composant externe, l’auteur spécifie : • les éléments du composant visibles ou non par l’utilisateur du composant. Les éléments visibles seront accessibles via le volet "Explorateur de projet" ou par programmation. • le mode d’utilisation du composant (comment utiliser le composant, les paramètres permettant d’accéder aux fonctionnalités du composant, etc.). Une documentation succincte (à compléter) est automatiquement générée et associée au composant. Remarque  : Des composants exemples sont livrés en standard avec WINDEV. Ces composants sont accessibles depuis le volet "Projet" de l’éditeur : sous le volet "Projet", dans le groupe "Projet", déroulez "Importer" et sélectionnez l’option "Un composant Externe .. Composant utilitaire ou exemple". Les pro- jets correspondants peuvent être ouverts depuis la page d’accueil de WINDEV (Ctrl + <). 1.2 De quoi est constitué un composant externe ? Un composant externe peut être : • défini et généré à partir d’un projet WINDEV, WEBDEV ou WINDEV Mobile existant. Une configuration de projet de type "Composant" permettra de sélectionner les éléments du projet existant à intégrer dans le composant. • créé à partir d’un projet de type "Composant externe". Ce projet est constitué par défaut d’une plateforme de type "Composant externe" qui contiendra les éléments nécessaires à la création et à la génération du composant. Ce composant externe peut être ensuite intégré dans d’autres projets WINDEV, WEBDEV, WINDEV Mobile. Tous les éléments du composant sont totalement in- dépendants du projet dans lequel le composant est intégré. Le composant externe peut avoir sa propre analyse, ses fenêtres, ses états, ses fichiers, etc. Lors de la génération du composant externe, il suffit d’indiquer si ces éléments seront accessibles ou non par le projet intégrant ce composant. Les éléments non accessibles ne seront ni visibles ni manipulables par le projet qui importera ce composant. Le composant externe est constitué de plusieurs fichiers : • <NomComposant>.WDK Fichier composant . Contient tous les éléments du composant. Ce fichier est nécessaire à l’intégration du composant dans un projet. Ce fichier doit également être livré dans la procédure d’installation de l’application utilisant le composant. • <NomComposant>.WDI Description du composant (uniquement pour le développement d’applications). Ce fichier est nécessaire à l’intégration du composant dans un projet. Ce fichier ne doit pas être livré dans la procédure d’installation de l’application utilisant le composant.