DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions diverses Windows
  • Chargement en mémoire d'un composant externe intégré au projet
  • Chargement d'un composant externe indépendant du projet
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Charge un composant externe. Ce composant peut être :
  • un composant externe présent dans le projet en cours. Dans ce cas le composant externe est chargé en mémoire jusqu'à ce que l'application se termine.
  • un composant externe indépendant du projet en cours. Le composant est chargé dans une variable de type Composant. Il est ainsi possible de récupérer une interface globale sur le composant.
Remarques :
  • Composant externe intégré au projet : Le mode de chargement du composant externe (au lancement du projet, ou à la première utilisation d'un élément du composant) est défini lors de l'intégration du composant dans le projet.
  • Lors du chargement du composant, les événements WLangage suivants sont exécutés :
    • Déclaration des classes du composant externe.
    • Déclaration des collections de procédures du composant externe.
    • Initialisation du composant externe.
Exemple
// Charger le composant externe intégré au projet
ResChargement est un entier
ResChargement = ComposantCharge(MonComposant, "C:\MonApplication")
SELON ResChargement
CAS cieAbsent :
Erreur("Le chemin spécifié ne correspond pas au composant externe indiqué")
CAS cieVersionTropAncienne, cieVersionTropRécente :
Erreur("La version du composant externe est incompatible avec l'exécutable")
CAS cieChargé :
Info("Composant externe chargé")
FIN
// Charment d'un composant
compo est un Composant
SI ComposantCharge(compo, fRepExe() + fSep() + "CompoExemple.wdk") ALORS
Trace("OK")
// Exécution des procédures du composant
Trace(ComposantExécute("ProcéduresGlobales.Test"))
Trace(ComposantExécute("ProcéduresGlobales.TestAvecParam", (1)))
FIN
Syntaxe

Charger un composant externe intégré au projet Masquer les détails

<Résultat> = ComposantCharge(<Nom du composant> [, <Répertoire du composant> [, <Mode de chargement>]])
<Résultat> : Constante de type entier
Compte-rendu du chargement :
cieAbsentLe composant externe n'est pas présent dans le chemin indiqué.
cieChargéLe composant externe s'est chargé correctement et est utilisable.
cieVersionTropAncienneLa version du composant externe est trop ancienne. Il est incompatible avec l'exécutable en cours.
cieVersionTropRécenteLa version du composant externe est trop récente. Il est incompatible avec l'exécutable en cours.
<Nom du composant> : Chaîne de caractères
Nom du composant externe (qui apparaît sous l'éditeur) à charger. Si le nom du composant externe n'est pas connu par le projet, une erreur WLangage apparaît.
<Répertoire du composant> : Chaîne de caractères optionnelle
Répertoire du composant externe (fichier WDK) à charger. Ce répertoire peut être terminé indifféremment par "\" ou non. Un chemin complet, relatif ou de type UNC peut être utilisé.
Si ce paramètre n'est pas précisé, le composant externe sera recherché :
<Mode de chargement> : Constante optionnelle de type Entier
Mode de chargement du composant externe. Correspond à une des constantes suivantes :
ccGlobalLe composant externe est chargé en global. Par exemple, le même contexte sera utilisé si le composant est chargé par le projet et par un composant du projet.
ccIsolé
(Valeur par défaut)
Le composant externe est isolé. Par exemple, si le composant est chargé par le projet et par un composant du projet, chaque composant utilisera un contexte spécifique.

Charger un composant externe indépendant du projet en cours Masquer les détails

<Résultat> = ComposantCharge(<Composant> , <Nom du composant>)
<Résultat> : Booléen
  • Vrai si le composant a été chargé,
  • Faux dans le cas contraire.
<Composant> : Variable de type Composant
Nom de la variable de type Composant dans laquelle le composant doit être chargé.
<Nom du composant> : Chaîne de caractères
Chemin complet et nom physique du composant externe à charger (fichier WDK).
Remarques

Chargement en mémoire d'un composant externe intégré au projet

Le mode de chargement du composant externe (au lancement du projet, ou à la première utilisation d'un élément du composant) est défini lors de l'intégration du composant dans le projet.
Pour modifier ce mode de chargement :
  1. Affichez la liste des composants externes importés dans le projet :
    • Dans le volet "Explorateur de projet", sélectionnez le dossier "Composants externes".
    • Affichez le menu contextuel du dossier et sélectionnez l'option "Liste des composants externes importés dans le projet".
  2. Sélectionnez le composant voulu et cliquez sur le bouton "Description".
  3. Modifiez le mode de chargement (option "Mode de chargement du composant").
Rappel : Lors du chargement d'un composant, les événements WLangage suivants sont exécutés :
  • Déclaration des classes du composant externe.
  • Déclaration des collections de procédures du composant externe.
  • Initialisation du composant externe.

Chargement d'un composant externe indépendant du projet

La fonction ComposantCharge ne provoque pas d'erreur fatale. La fonction renvoie Faux dans les cas suivants :
  • le composant n'est pas trouvé.
  • il y a une tentative de remplacement du composant chargé par un autre composant.
Classification Métier / UI : Code neutre
Composante : wd300vm.dll
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/03/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale