|
|
|
|
|
|
|
|
- Chargement en mémoire d'un composant externe intégré au projet
- Chargement d'un composant externe indépendant du projet
ComposantCharge (Fonction) En anglais : ComponentLoad 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.
 Nouveauté 28un 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.
// 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
Nouveauté 28
// 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 :
| | | cieAbsent | Le composant externe n'est pas présent dans le chemin indiqué. | | cieChargé | Le composant externe s'est chargé correctement et est utilisable. | | cieVersionTropAncienne | La version du composant externe est trop ancienne. Il est incompatible avec l'exécutable en cours. | | cieVersionTropRécente | La 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 :
| | | ccGlobal | Le 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. |
Nouveauté 28
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 : - 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".
- Sélectionnez le composant voulu et cliquez sur le bouton "Description".
- 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.
Nouveauté 28Chargement 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
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|