DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Syntaxe WLangage / Procédures WLangage
  • Présentation
  • Documentation automatique
  • Paramétrage
  • Que contiennent les commentaires ?
  • Remarque : suppression de paramètres
  • Saisie assistée
  • Saisie assistée sur les procédures et méthodes de classe
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
Présentation
Pour simplifier les phases de maintenance ou la reprise par d'autres développeurs de code existant, WINDEV, WEBDEV et WINDEV Mobile proposent une documentation automatique des procédures (ou méthodes de classes).
Cette documentation automatique correspond à un ensemble de commentaires. Ces commentaires sont générés :
  • Soit à la création d'une nouvelle procédure ou méthode.
    Vous pouvez choisir si vous voulez générer les commentaires dans la fenêtre qui s'affiche lors de la création d'une procédure ou méthode (option "Générer un commentaire d'en-tête"). Les commentaires générés respecteront le paramétrage de la documentation automatique.
  • Soit grâce à l'icône Commentaires (présente dans le coin haut droit de la fenêtre de code d'une procédure). Cette icône permet de générer ou de supprimer un ensemble de commentaires pour la procédure en cours.
Il est également possible de :
  • Synchroniser automatiquement les commentaires générés en fonction de la syntaxe des procédures. Une modification de la syntaxe entraîne la mise à jour des commentaires associés (lors de la sauvegarde).
  • Utiliser la saisie assistée lors de l'écriture de l'appel aux procédures ou méthodes documentées. Pour plus de détails, consultez le paragraphe Saisie assistée.
Par défaut, les commentaires générés utilisent le format historique, précédés par les caractères '//'. Il est possible de générer les commentaires au format Doxygen (précédés par des tags spécifiques). Le choix du format de génération des commentaires est effectué dans l'onglet "Options" de la description du projet :
  1. Sous le volet 'Projet", dans le groupe "Projet", cliquez sur "Description".
  2. Dans la fenêtre qui s'affiche, cliquez sur l'onglet "Options".
  3. L'option "Format des commentaires automatiques" permet de choisir le format utilisé par la génération automatiques des commentaires de procédures.
    Deux formats sont disponibles :
    • format historique.
    • format Doxygen.
  4. Validez.
Documentation automatique

Paramétrage

Pour paramétrer la documentation automatique :
  1. Sous le volet "Accueil", dans le groupe "Environnement", déroulez "Options" et sélectionnez "Options de l'éditeur de code".
  2. Affichez l'onglet "Doc.".
Options d'édition
Important : Chaque bloc de commentaires doit respecter le format détaillé ci-dessous. En particulier, la description de chaque paramètre ainsi que la description de la valeur de retour doivent être effectuées sur une seule ligne. Dans le cas contraire, des décalages pourront être observés.

Que contiennent les commentaires ?

Le commentaire d'une fonction ou d'une procédure peut contenir les éléments suivants :
  • Résumé : le commentaire correspondant est le suivant :
    Résumé
    ou
    Résumé
  • Entête de description de la procédure : le commentaire correspondant est le suivant :
    Entête de description
  • Syntaxe d'appel : le commentaire correspondant est le suivant :
    Syntaxe
  • Détail des paramètres : le commentaire correspondant est le suivant :
    Détail des paramètres
    ou
  • Timer automatique : le commentaire correspondant permet de décrire le timer automatique défini pour la fonction ou la procédure :
    Timer automatique
  • Gestion automatique des erreurs et des exceptions : le commentaire correspondant permet de décrire le mode de gestion des erreurs et des exceptions (défini via le lien "Si Erreur" dans le bandeau d'entête de la procédure). Par exemple :
    Erreurs et exceptions
  • Note : le commentaire correspondant est le suivant :
    Note
    ou
  • Exemple : le commentaire correspondant est le suivant :
    Exemple
  • Marque indiquant que la procédure doit être documentée : le commentaire correspondant est le suivant :
    Marque

Remarque : suppression de paramètres

Si un paramètre est spécifié dans la syntaxe de la procédure, puis supprimé, la référence au paramètre est toujours visible dans la section "Détail des paramètres" des commentaires.
Le texte saisi par le développeur concernant le paramètre doit être supprimé par le développeur (limite les risques de suppression par "inadvertance").
L'option "Synchroniser les commentaires avec les syntaxes des procédures" permet de conserver des commentaires à jour quelques soient les modifications effectuées.
Saisie assistée

Saisie assistée sur les procédures et méthodes de classe

Si les paramètres d'une procédure ont été documentés, et si la saisie assistée est disponible dans l'éditeur de code, lors de la saisie de l'appel à la procédure, la syntaxe et la description des paramètres apparaissent dans une bulle d'aide. Par exemple :
  1. Documentation de la procédure :
    Documentation de la procédure
  2. Saisie assistée sur la procédure :
    Bulle d'aide (saisie assistée)
Le mécanisme de saisie assistée sur les procédures et les méthodes est identique à celui utilisé pour les fonctions WLangage. Pour plus de détails sur le paramétrage de la saisie assistée dans WINDEV, WEBDEV ou WINDEV Mobile, consultez Saisie assistée sur les fonctions WLangage.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 26/04/2024

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