• Intégrer un composant externe dans une application.
• Manipuler les éléments d'un composant externe par programmation.
• Mettre à jour un composant externe dans une application utilisant un composant.
• Déployer et mettre à jour l'application utilisant un composant externe.

Intégrer un composant dans un projet

1. Ouvrez le projet sous WINDEV, WEBDEV ou WINDEV Mobile.
2. Sous le volet "Projet", dans le groupe "Projet", déroulez "Importer" et sélectionnez "Un composant externe .. A partir d'un fichier". Un sélecteur de fichiers s'ouvre.
3. Sélectionnez le fichier WDI du composant à importer. Selon le mode de diffusion choisi, ce fichier peut être présent :
   • soit dans le répertoire de création du composant si le poste de création et d'utilisation du composant sont identiques,
   • soit dans le répertoire où les fichiers du composant ont été mis à disposition,
   • soit dans le répertoire où la procédure d'installation du composant a copié les fichiers du composant.
     Pour plus de détails, consultez Distribuer un composant.
4. Validez. La fenêtre de description du composant sélectionné apparaît. Cette fenêtre présente :
   • la description du composant (société, version, ...).
     Il est possible de choisir le mode de chargement du composant (au lancement du projet ou à la première utilisation d'un élément du composant). Par défaut, le composant est chargé à la première utilisation d'un élément du composant.
   • la documentation du composant. Cette documentation permet de savoir comment utiliser les différents éléments du composant.
5. Validez. Les différents éléments accessibles et utilisables du composant apparaissent dans le volet "Explorateur du projet". Une icône spécifique indique que l'élément provient d'un composant.

Fichiers automatiquement copiés lors de l'intégration du composant dans un projet

• Le fichier <Nom du composant>.WDI est copié dans le répertoire du projet.
• Le fichier <Nom du composant>.WDK est copié dans le sous-répertoire EXE du projet.
• Si des fichiers ont été spécifiés dans le fichier optionnel <Nom du composant>.WDO, ces fichiers sont recopiés dans le répertoire EXE du projet (en respectant l'arborescence précisée dans le fichier WDO).

1. Consultez la documentation de l'élément.
   Pour cela, effectuez une des manipulations suivantes :
   • double-cliquez sur l'élément depuis le volet "Explorateur du projet".
   • appuyez sur la touche F2 depuis le code de l'élément.
2. La documentation de l'élément apparaît sous l'éditeur de code. Cette documentation présente les paramètres nécessaires à l'utilisation de l'élément (paramètres attendus en entrée ou en sortie, ...).
3. Utilisez l'élément selon les informations précisées dans la documentation comme si cet élément appartenait au projet.
   • Pour ouvrir une fenêtre, utilisez par exemple la fonction Ouvre en passant si nécessaire les paramètres attendus par cette fenêtre.
     
     Ouvre(FenêtreDuComposant [, Param1, Param2])
   • Pour imprimer un état, utilisez la fonction iImprimeEtat en passant si nécessaire les paramètres attendus par cet état.
     
     iImprimeEtat(EtatComposant [, Param1, Param2])
   • Pour appeler une procédure, utilisez la syntaxe habituelle.
     
     ProcédureDuComposant(Param1,Param2)
   • Pour utiliser une classe, déclarez une variable du type de la classe.
     
     MaVariable est un objet ClasseDuComposant
     
     La variable s'utilise par la suite comme une variable objet normale.

Remarque : la documentation technique du composant

• lors de l'intégration d'un composant dans un projet : sous le volet "Projet", dans le groupe "Projet", déroulez "Importer" et sélectionnez "Un composant externe .. A partir d'un fichier".
• à tout moment, dans la description des composants intégrés dans le projet :
  • Sous le volet "Explorateur de projet", sélectionnez le dossier "Composants externes".
  • Affichez le menu contextuel et sélectionnez "Liste des composants externes importés dans le projet".
  • Le bouton [Description] permet d'obtenir les informations et la documentation du composant.

Conflits de noms

Utiliser une procédure d'un composant en compilation dynamique

1. Il est nécessaire que le composant soit chargé. Le composant peut être défini comme "Chargé au lancement de l'application" ou chargé grâce à la fonction ComposantCharge.
2. Il est nécessaire d'utiliser le nom complet pour désigner la procédure et de faire suivre ce nom de parenthèses pour indiquer qu'une procédure doit être utilisée (et non une variable globale) :
   
   NomComposant.NomCollection.NomProcédure()
   
   Remarque : Il est également possible d'utiliser la fonction Exécute :
   
   Exécute("NomComposant.NomCollection.NomProcédure")

Classes et composants

• Lorsque une nouvelle version d'un composant est disponible, il suffit d'installer les nouveaux fichiers de cette mise à jour dans le répertoire d'installation du composant (selon le mode d'installation utilisé). Pour plus de détails sur les différents modes d'installation d'un composant, consultez Distribuer un composant.
• Lors de l'ouverture du projet utilisant ce composant, le changement de version du composant sera automatiquement détecté et une mise à jour du projet sera proposée. Il est conseillé de recompiler le projet.
  Remarque : Il est possible de forcer la mise à jour d'un composant depuis la liste des composants présents dans le projet :
  • Sous le volet "Explorateur de projet", sélectionnez le dossier "Composants externes".
  • Affichez le menu contextuel et sélectionnez "Liste des composants externes importés dans le projet".
  • Cliquez sur bouton "Mise à jour".
• Si le composant a été distribué avec une application WINDEV, il est nécessaire de mettre le composant à jour. Pour plus de détails, consultez Déploiement d'une application utilisant un composant.