Formatage du code source

De Appmethod Topics
Aller à : navigation, rechercher

Remonter à Comment modifier le code dans l'éditeur de code


Lors de l'édition du code Object Pascal ou C++ dans l'éditeur de code, vous pouvez appliquer la commande de menu contextuel Formater le source pour formater le code source. Sous le groupe Formateur de la boîte de dialogue Options (Outils > Options), vous pouvez définir les options de formatage pour Indentation, Espaces, Sauts de ligne et Capitalisation. Utilisez les groupes Object Pascal et C++ pour spécifier des ensembles distincts d'options de formatage pour le code source Object Pascal ou C++.

Notez que le formateur de code source ne prend en compte que les options de formatage spécifiées. Il redéfinit complètement le formatage manuel que vous avez implémenté dans l'éditeur de code.

Pour activer le formateur

  1. Cliquez sur Outils > Options.
  2. Dans l'arborescence du volet de gauche de la boîte de dialogue Options, développez le noeud Formateur.
  3. Sélectionnez le noeud Profils et statut -- la page Profils et statut du formateur s'ouvre.
  4. Sélectionnez Activer le formateur.
  5. Cliquez sur OK. Les commandes de formatage du code source deviennent activées. C'est-à-dire que les commandes Formater le source et Formater les sources du projet apparaissent dans les menus correspondants (et les menus contextuels) et deviennent disponibles.
Dans la page Profils et statut, vous pouvez aussi gérer les jeux d'options du formateur (en utilisant les fichiers de configuration stockant les options du formateur), activer et désactiver le message d'invite de confirmation avant les opérations de formatage.

Pour personnaliser les options du formateur

  1. Cliquez sur Outils > Options.
  2. Dans l'arborescence du volet de gauche de la boîte de dialogue Options, développez le noeud Formateur. Les sous-arborescences C++ et Object Pascal s'ouvrent.
    • La sous-arborescence C++ contient les groupes d'options Indentation, Espaces, Sauts de ligne et Aligner. Les options C++ sont utilisées dans les projets C++ pour formater les fichiers de code source C/C++ avec les extensions suivantes : *.cpp, *.cxx, *.cc, *.c, *.hpp, *.hxx, *.hh, *.h.
    • Object Pascal contient les groupes d'options Indentation, Espaces, Sauts de ligne, Capitalisation et Aligner. Les options Object Pascal sont utilisées dans les projets Object Pascal pour formater les fichiers de code source Object Pascal avec les extensions suivantes : *.pas, *.dpr, *.dpk, *.dpkw, *.inc.
  3. Sélectionnez un groupe d'options. Le volet de droite affiche les options du groupe sélectionné.
  4. Sélectionnez une option. Une description détaillée de cette option apparaît dans la partie inférieure ou le volet de droite.
  5. Pour modifier la valeur de l'option (ou visualiser toutes les valeurs possibles de l'option), cliquez sur la flèche déroulante de la colonne de droite de la ligne de l'option. La liste de toutes les valeurs possibles s'ouvre.
  6. Sélectionnez la valeur désirée.
  7. Cliquez sur OK. Le jeu spécifié d'options du formateur sera utilisé par le formateur du code source.

Pour formater le fichier de code source

  1. Ouvrez votre fichier de code source Object Pascal ou C++ dans l'éditeur de code.
  2. Définissez les options de formatage désirées (selon les besoins).
  3. Cliquez avec le bouton droit dans l'éditeur de code et sélectionnez la commande Formater le source dans le menu contextuel (ou cliquez sur la commande de menu Edition > Formater le source).
  4. Si l'invite de confirmation s'ouvre, cliquez sur Oui.
  5. Le volet Editeur de code actualise et présente le code source formaté selon les options spécifiées du formateur.

Pour formater le bloc de code source

  1. Ouvrez votre fichier de code source Object Pascal ou C++ dans l'éditeur de code.
  2. Définissez les options de formatage désirées (selon les besoins).
  3. Sélectionnez un bloc de code.
  4. Cliquez avec le bouton droit dans le bloc sélectionné et sélectionnez la commande Formater le source dans le menu contextuel (ou cliquez sur la commande de menu Edition > Formater le source).
  5. Si l'invite de confirmation s'ouvre, cliquez sur Oui.
  6. Le volet Editeur de code actualise et présente le bloc sélectionné, formaté selon les options spécifiées du formateur. Seul le formatage du bloc sélectionné sera mis à jour.

Pour formater les fichiers de code source d'un projet

  1. Dans le Gestionnaire de projets, sélectionnez un projet à activer.
  2. Exécutez la commande Formater les sources du projet :
    • Cliquez avec le bouton droit dans le Gestionnaire de projets et sélectionnez la commande de menu contextuel Formater les sources du projet, ou
    • Sélectionnez la commande de menu Projet > Formater les sources du projet.
  3. L'invite de confirmation Formater les sources du projet s'ouvre. Cliquez sur OK.

Le formateur formatera les sources de tous les fichiers de code source de ce projet et mettra à jour les fichiers avec les codes source modifiés.

Pour utiliser les profils du formateur

  1. Cliquez sur Outils > Options.
  2. Dans l'arborescence du volet de gauche de la boîte de dialogue Options, développez le noeud Formateur.
  3. Sélectionnez le noeud Profils et statut ; la page Profils et statut du formateur s'ouvre.
  4. Dans le groupe Sélectionner un profil, cliquez dans Profils pour afficher la liste des profils accessibles et sélectionner un profil. Le nom du profil sélectionné apparaît dans Profils.
Les profils sont un type spécial de fichiers stockant les options du formateur. Pour être présenté dans la liste Profils, un fichier doit :
  • Correspondre au masque de fichier Formatter_*.config.
  • Etre situé dans le répertoire de travail de Appmethod : C:\Users\<nom d'utilisateur>\AppData\Roaming\Embarcadero\BDS\17.0.
Le jeu standard de profils inclut Formatter_Compact.config, Formatter_Default.config et Formatter_Wide.config.
Les jeux d'options de formateur stockés dans les profils peuvent être traités en tant que profils de formateur.
  1. Cliquez sur Appliquer. Le jeu d'options du formateur stocké dans le profil sélectionné constitue les options actives du formateur.
  2. C'est-à-dire que nous pouvons dire que nous chargeons le profil du formateur depuis le profil sélectionné.

Pour enregistrer le jeu personnalisé d'options du formateur dans un fichier

  1. Cliquez sur Outils > Options.
  2. Dans l'arborescence du volet de gauche de la boîte de dialogue Options, développez le noeud Formateur. Personnalisez les options du formateur comme décrit dans la section Pour personnaliser les options du formateur.
  3. Sélectionnez le noeud Profils et statut ; la page Profils et statut du formateur s'ouvre. Cliquez sur Enregistrer sous. La boîte de dialogue Enregistrer le profil du formateur s'ouvre.
    • Par défaut, cette boîte de dialogue suggère d'enregistrer un fichier dans le répertoire de travail de Appmethod.
    • Par défaut, le filtre Type utilise le masque de fichier Profiles (Formatter_*.config).
  4. Dans Nom du fichier, spécifiez le nom du fichier où sera enregistré le jeu en cours des options du formateur.
  5. Cliquez sur Enregistrer.
Votre jeu personnalisé d'options du formateur sera enregistré dans le fichier spécifié.

Pour charger le jeu d'options du formateur depuis un fichier

  1. Cliquez sur Outils > Options.
  2. Dans l'arborescence du volet de gauche de la boîte de dialogue Options, développez le noeud Formateur.
  3. Sélectionnez le noeud Profils et statut ; la page Profils et statut du formateur s'ouvre. Cliquez sur Charger. La boîte de dialogue Charger le profil du formateur s'ouvre.
    • Par défaut, cette boîte de dialogue suggère de charger un fichier depuis le répertoire de travail de Appmethod.
    • Par défaut, le filtre Fichiers de type utilise le masque de fichier Profiles (Formatter_*.config).
Les fichiers avec ce masque, situés dans le répertoire de travail de Appmethod, sont les soi-disant profils. Par conséquent, la liste des fichiers du volet principal ne montre par défaut que les profils existants. Pour présenter d'autres fichiers stockant des options de formateur, sélectionnez Config files (*.config) dans le filtre Fichiers de type.
  1. Dans Nom du fichier, spécifiez le nom du fichier à partir duquel sera chargé le jeu stocké d'options du formateur.
  2. Cliquez sur Ouvrir.
  3. Le jeu d'options du formateur stocké dans le fichier spécifié est chargé et il devient le jeu en cours des options du formateur.

Voir aussi