DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Composant / Composant Externe
  • Présentation
  • Tableau récapitulatif des éléments et des options de visibilité
  • Comment utiliser une variable globale depuis un composant
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
Visibilité des éléments d'un composant externe
Présentation
Lors de la création d'un composant externe, il est possible de définir les éléments du composant externe qui seront accessibles ou non par l'utilisateur du composant.
  • Si l'élément est accessible, l'utilisateur du composant verra cet élément dans la liste des éléments du projet. Il pourra manipuler cet élément par programmation (comme s'il s'agissait d'un élément créé dans son projet).
    Remarque : Le code de cet élément n'est cependant 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, ...), les éléments accessibles ou non peuvent varier. Le tableau ci-dessous récapitule les différentes façons d'accéder à un élément en fonction de son mode de déclaration.
Tableau récapitulatif des éléments et des options de visibilité
ÉlémentNon accessibleAccessible
ClasseAucun accès à la classe, à ses membres ou à ses méthodesLa syntaxe utilisée pour accéder à la classe, à ses membres ou à ses méthodes doit être conforme à la syntaxe de la POO dans WINDEV.
Si le membre ou la méthode est public (cas par défaut) dans le composant, le membre ou la méthode seront publics dans le projet utilisant le composant.

Si le membre ou la méthode est protégé dans le composant, le membre ou la méthode seront protégés dans le projet utilisant le composant.

Si le membre ou la méthode est privé dans le composant, le membre ou la méthode ne seront pas accessibles dans le projet utilisant le composant.
FenêtreAucun accès à la fenêtreLes variables globales de la fenêtre ne peuvent pas être manipulées. Si ces variables doivent être manipulées, il est nécessaire d'inclure dans le composant des procédures permettant de lire ou de modifier les variables globales de la fenêtre.
Si ces procédures sont sans attribut d'accès dans le composant, ces procédures seront invisibles dans le projet utilisant le composant.

Si ces procédures sont publiques dans le composant, ces procédures seront publiques dans le projet utilisant le composant.

Si ces procédures sont privées dans le composant, ces procédures ne seront pas accessibles dans le projet utilisant le composant.
Collection de procéduresAucun accès aux procéduresLes variables globales de la collection de procédures ne peuvent pas être manipulées. Si ces variables doivent être manipulées, il est nécessaire d'inclure dans le composant des procédures permettant de lire ou de modifier les variables globales de la collection de procédures.
Si la procédure est sans attribut d'accès dans le composant, cette procédure est invisible dans le projet utilisant le composant.

Si la procédure est publique dans le composant, la procédure sera publique dans le projet utilisant le composant.

Si la procédure est privée dans le composant, la procédure ne sera pas accessible dans le projet utilisant le composant.
Projet (fichier WDP, WWP ou WPP)Le projet peut être intégré ou non au composant. Il n'est pas possible de définir des options de visibilité. Le projet sera toujours invisible.

Si le projet est intégré au composant, le code d'initialisation du projet et de fermeture du projet seront automatiquement exécutés au chargement / déchargement du composant.

Attention : si l'analyse intégrée au composant est protégée par un mot de passe, il est nécessaire d'intégrer le projet au composant pour spécifier ce mot de passe.
AnalyseL'analyse peut être intégrée ou non au composant. Il n'est pas possible de définir des options de visibilité. L'analyse sera toujours invisible.

Attention : si une analyse est intégrée dans le composant et si un mot de passe a été défini pour cette analyse, il est nécessaire d'intégrer le projet au composant.
RequêteLes requêtes peuvent être intégrées ou non au composant. Il n'est pas possible de définir des options de visibilité. Les requêtes seront toujours invisibles.

Remarque : Par défaut, les éléments d'un composant utilisent un contexte HFSQL indépendant.

Comment utiliser une variable globale depuis un composant

Le but du composant étant généralement d'être autonome, il n'est pas recommandé d'utiliser une variable globale du projet depuis celui-ci.
La méthode recommandée est cependant la suivante :
  • créez une variable globale dans le composant.
  • créez dans le composant une procédure permettant d'initialiser cette variable globale.
  • depuis le code d'initialisation du projet, et à chaque modification de la valeur des variables globales du projet, appelez cette procédure pour affecter une valeur similaire aux variables globales du composant.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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