|
- Présentation
- Procédure locale
- Procédures locales à une fenêtre
- Procédures locales à une page
- Procédures locales à un état
- Procédures locales à un champ
- Création d'une procédure locale
- Création depuis l'éditeur de code
- Création depuis le volet "Explorateur de projet"
- Afficher la liste des procédures locales
- Suppression d'une procédure locale
- Procédure locale publique ou privée
Les procédures peuvent être de deux types : - Procédure globale : utilisable dans tous les traitements/événements du projet. Cette procédure globale est mémorisée dans le projet.
- Procédure locale : utilisable dans tous les traitements/événements dépendant de l'objet (fenêtre, page, état ou champ) dans lequel cette procédure a été déclarée. Cette procédure locale est mémorisée dans l'objet.
Versions 26 et supérieuresA partir de la version 26, il est possible de créer des procédures locales aux champs (d'une fenêtre ou d'un état). Nouveauté 26A partir de la version 26, il est possible de créer des procédures locales aux champs (d'une fenêtre ou d'un état). A partir de la version 26, il est possible de créer des procédures locales aux champs (d'une fenêtre ou d'un état).
Important : Il ne faut pas déclarer deux procédures avec le même nom (notamment une procédure globale et une procédure locale). Rappel : - En WLangage, il n'existe pas de distinction entre les procédures et les fonctions. Les syntaxes de déclaration et d'utilisation décrites pour les procédures sont les mêmes pour les fonctions.
Versions 16 et supérieuresIl est possible de créer des procédures multisyntaxes. Pour plus de détails, consultez Surcharge de prototype. Nouveauté 16Il est possible de créer des procédures multisyntaxes. Pour plus de détails, consultez Surcharge de prototype. Il est possible de créer des procédures multisyntaxes. Pour plus de détails, consultez Surcharge de prototype.
Versions 17 et supérieures Nouveauté 17 Versions 18 et supérieures Nouveauté 18 Versions 21 et supérieures Nouveauté 21 Versions 26 et supérieuresProcédures locales à un champ Les procédures locales déclarées dans un champ peuvent être appelées depuis tous les traitements/événements : - du champ,
- des procédures locales associées au champ.
Ces procédures sont mémorisées avec le champ. Lors de la copie du champ, les procédures locales associées au champ seront copiées. Une procédure locale à un champ peut être créée pour un champ d'une fenêtre, d'une page ou d'un état. Nouveauté 26Procédures locales à un champ Les procédures locales déclarées dans un champ peuvent être appelées depuis tous les traitements/événements : - du champ,
- des procédures locales associées au champ.
Ces procédures sont mémorisées avec le champ. Lors de la copie du champ, les procédures locales associées au champ seront copiées. Une procédure locale à un champ peut être créée pour un champ d'une fenêtre, d'une page ou d'un état. Procédures locales à un champ Les procédures locales déclarées dans un champ peuvent être appelées depuis tous les traitements/événements :- du champ,
- des procédures locales associées au champ.
Ces procédures sont mémorisées avec le champ. Lors de la copie du champ, les procédures locales associées au champ seront copiées. Une procédure locale à un champ peut être créée pour un champ d'une fenêtre, d'une page ou d'un état. Création d'une procédure locale Création depuis l'éditeur de code Pour créer une procédure locale à l'élément en cours depuis l'éditeur de code : - Méthode 1 :
 Pour créer une procédure locale à une fenêtre, un champ, un état, sous le volet "Code", dans le groupe "Procédures", déroulez "Nouveau" et sélectionnez "Nouvelle procédure locale" (raccourci clavier F4). Pour créer une procédure locale serveur à une page ou à un champ d'une page : sous le volet "Code", dans le groupe "Procédures", déroulez "Nouveau" et sélectionnez "Nouvelle procédure locale (Serveur)". Pour créer une procédure locale navigateur à une page : sous le volet "Code", dans le groupe "Procédures", déroulez "Nouveau" et sélectionnez "Nouvelle procédure locale (Navigateur)". - Dans la fenêtre qui s'affiche :
- Indiquez le nom de la procédure à créer.
Versions 21 et supérieuresL'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure. Pour plus de détails, consultez Documentation automatique des procédures. Nouveauté 21L'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure. Pour plus de détails, consultez Documentation automatique des procédures. L'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure. Pour plus de détails, consultez Documentation automatique des procédures. Versions 24 et supérieuresIndiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini". Nouveauté 24Indiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini". Indiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini". Versions 26 et supérieuresSi l'éditeur de code affiche le code d'un champ, l'option "Créer la procédure au niveau du champ" permet de spécifier si la procédure locale doit être associée au champ ou non. Nouveauté 26Si l'éditeur de code affiche le code d'un champ, l'option "Créer la procédure au niveau du champ" permet de spécifier si la procédure locale doit être associée au champ ou non. Si l'éditeur de code affiche le code d'un champ, l'option "Créer la procédure au niveau du champ" permet de spécifier si la procédure locale doit être associée au champ ou non.
- Cliquez sur le bouton "Ajouter". La procédure locale est créée. Par défaut, la procédure créée est publique. Pour plus de détails, consultez le paragraphe Procédure locale publique ou privée.
- Méthode 2 :
 Pour créer une procédure locale : sélectionnez l'option "Nouveau .. Nouvelle procédure locale" du menu contextuel. Pour créer une procédure locale serveur, sélectionnez l'option "Nouveau .. Nouvelle procédure locale (Serveur)". Pour créer une procédure locale navigateur, sélectionnez l'option "Nouveau .. Nouvelle procédure locale (Navigateur)". - Dans la fenêtre qui s'affiche :
- Indiquez le nom de la procédure à créer.
Versions 21 et supérieuresL'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure. Pour plus de détails, consultez Documentation automatique des procédures. Nouveauté 21L'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure. Pour plus de détails, consultez Documentation automatique des procédures. L'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure. Pour plus de détails, consultez Documentation automatique des procédures. Versions 24 et supérieuresIndiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini". Nouveauté 24Indiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini". Indiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini". Versions 26 et supérieuresSi l'éditeur de code affiche le code d'un champ, l'option "Créer la procédure au niveau du champ" permet de spécifier si la procédure locale doit être associée au champ ou non. Nouveauté 26Si l'éditeur de code affiche le code d'un champ, l'option "Créer la procédure au niveau du champ" permet de spécifier si la procédure locale doit être associée au champ ou non. Si l'éditeur de code affiche le code d'un champ, l'option "Créer la procédure au niveau du champ" permet de spécifier si la procédure locale doit être associée au champ ou non.
- Cliquez sur le bouton "Ajouter". La procédure locale est créée. Par défaut, la procédure créée est publique. Pour plus de détails, consultez le paragraphe Procédure locale publique ou privée.
Versions 22 et supérieuresMéthode 3 : Pour créer une procédure locale : - Positionnez le curseur dans l'événement "Déclarations globales" de la fenêtre ou de la page, ou dans l'événement "Ouverture" de l'état.
- Tapez le prototype de la procédure à créer.
- Validez. La procédure locale est automatiquement créée.
Nouveauté 22Méthode 3 : Pour créer une procédure locale : - Positionnez le curseur dans l'événement "Déclarations globales" de la fenêtre ou de la page, ou dans l'événement "Ouverture" de l'état.
- Tapez le prototype de la procédure à créer.
- Validez. La procédure locale est automatiquement créée.
Méthode 3 : Pour créer une procédure locale :- Positionnez le curseur dans l'événement "Déclarations globales" de la fenêtre ou de la page, ou dans l'événement "Ouverture" de l'état.
- Tapez le prototype de la procédure à créer.
- Validez. La procédure locale est automatiquement créée.
Remarque : Pour transformer une partie de code déjà saisi dans une procédure locale en une procédure locale : - Sélectionnez le code correspondant.
- Utilisez l'option "Nouveau .. Créer une procédure locale contenant le code sélectionné" du menu contextuel.
- Indiquez :
- le nom de la procédure.
Versions 19 et supérieuresla portée de la procédure. Par défaut, la procédure créée est publique. Pour plus de détails, consultez le paragraphe Procédure locale publique ou privée. la portée de la procédure. Par défaut, la procédure créée est publique. Pour plus de détails, consultez le paragraphe Procédure locale publique ou privée.
- La procédure est créée, le code correspondant est remplacé par l'appel de la procédure avec les paramètres nécessaires.
Création depuis le volet "Explorateur de projet" Pour créer une procédure locale depuis le volet "Explorateur de projet" : - Sélectionnez l'élément associé à la procédure locale (fenêtre, page, état, champ, ...).
- Déroulez les options de l'élément et sélectionnez l'option "Procédures" de l'élément.
Remarque : Pour les champs, si aucune procédure n'est associée au champ, l'option "Procédures" n'est pas affichée. Dans ce cas, sélectionnez le nom du champ. - Affichez le menu contextuel.
- Sélectionnez :
l'option "Nouvelle procédure". l'option "Nouvelle procédure serveur". l'option "Nouvelle procédure navigateur". Versions 24 et supérieures l'option "Nouvelle procédure mixte". Nouveauté 24 l'option "Nouvelle procédure mixte".  l'option "Nouvelle procédure mixte".
- Dans la fenêtre qui s'affiche :
- Indiquez le nom de la nouvelle procédure locale.
Versions 21 et supérieuresL'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure. Pour plus de détails, consultez Documentation automatique des procédures. Nouveauté 21L'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure. Pour plus de détails, consultez Documentation automatique des procédures. L'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure. Pour plus de détails, consultez Documentation automatique des procédures. Versions 24 et supérieuresIndiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini". Nouveauté 24Indiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini". Indiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini".
- Cliquez sur le bouton "Ajouter". La procédure locale est créée. Par défaut, la procédure créée est publique. Pour plus de détails, consultez le paragraphe Procédure locale publique ou privée.
- Validez.
Afficher la liste des procédures locales Pour afficher la liste des procédures locales dans le volet "Explorateur de projet", utilisez la touche F8 sous l'éditeur de code. Suppression d'une procédure locale Pour supprimer une procédure locale depuis le volet "Explorateur de projet" : - Sélectionnez l'élément associé à la procédure locale (fenêtre, page, état, champ, ...).
- Déroulez les options de l'élément.
- Déroulez l'option "Procédures" de l'élément.
- Sélectionnez la procédure voulue.
- Affichez le menu contextuel de la procédure et sélectionnez l'option "Supprimer".
Procédure locale publique ou privée Une procédure locale est publique par défaut : elle est accessible depuis n'importe quel code. Dans certains cas, il est nécessaire de restreindre l'accès à une procédure locale en la rendant "Privée". Versions 19 et supérieuresLors de la création d'une procédure locale, il est possible de spécifier si la procédure est publique ou privée. Nouveauté 19Lors de la création d'une procédure locale, il est possible de spécifier si la procédure est publique ou privée. Lors de la création d'une procédure locale, il est possible de spécifier si la procédure est publique ou privée.Pour modifier le mode d'accès à une procédure locale : - Sélectionnez la procédure locale dans le volet "Explorateur de projet".
- Dans le menu contextuel de la procédure, sélectionnez le nouveau mode d'accès :
Versions 16 et supérieuresLa couleur du bandeau de la procédure change en fonction de son mode d'accès : - début de bandeau rouge : procédure privée.
- début de bandeau habituel : procédure publique.
Nouveauté 16La couleur du bandeau de la procédure change en fonction de son mode d'accès : - début de bandeau rouge : procédure privée.
- début de bandeau habituel : procédure publique.
La couleur du bandeau de la procédure change en fonction de son mode d'accès : - début de bandeau rouge : procédure privée.
- début de bandeau habituel : procédure publique.
Remarque : Composant externe et procédures locales privées ou publiques : L'utilisation de procédures locales privées ou publiques a un impact notamment dans les composants externes. En effet, seules les procédures explicitement publiques (utilisant le mot-clé PUBLIC dans leur prototype) présentes dans un composant externe pourront pas être accessibles depuis le projet intégrant ce composant.
Documentation également disponible pour…
|
|
|
| |
| Cliquez sur [Ajouter] pour publier un commentaire |
|
| |
|
| |
| |
| |
| |
| |
| |
| | |
| |