Formatage du code source

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

Lors de l'édition du code {{Delphi} 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 > Langage > Formateur), vous pouvez définir des options de formatage (Indentation, Espaces, Sauts de ligne et Aligner). Utilisez les groupes Delphi et C++ pour spécifier des ensembles distincts d'options de formatage pour le code source Delphi 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 > Langage >Formateur.
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 > Langage >Formateur.
2. Dans l'arborescence du volet de gauche de la boîte de dialogue Options, développez le noeud Formateur. Les sous-arborescences Delphi s'ouvrent.
   • 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. Pour plus d’informations, voir Formatage.
   • Delphi contient les groupes d'options Indentation, Espaces, Sauts de ligne, Capitalisation et Alignement. Les options Delphi sont utilisées dans les projets Delphi pour formater les fichiers de code source Delphi ayant 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 du volet droit.
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 Delphi 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 Delphi 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 > Langage >Formateur.
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électionnez 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 RAD Studio : C:\Users\<nom d'utilisateur>\AppData\Roaming\Embarcadero\BDS\22.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.

5. Cliquez sur Appliquer. Le jeu d'options du formateur stocké dans le profil sélectionné constitue les options actives du formateur. Ce qui signifie 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 > Langage >Formateur.
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 propose d'enregistrer un fichier dans le répertoire de travail RAD Studio.
   • 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 > Langage >Formateur.
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 propose de charger un fichier depuis le répertoire de travail RAD Studio.
   • Par défaut, le filtre Fichiers de type utilise le masque de fichier Profiles (Formatter_*.config).

Les fichiers portant ce masque situés dans le répertoire de travail RAD Studio sont ce qu'on appelle des 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 Fichiers config (*.config) dans le filtre Fichiers de type.

4. Dans Nom du fichier, spécifiez le nom du fichier depuis lequel le jeu des options du formateur sera chargé.
5. Cliquez sur Ouvrir. 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

• Formateur de code
  • Formateur intégré
  • Options du formateur
  • Formatage
  • Page Profils et statut
  • Formatter.EXE, le formateur en ligne de commande

• Formateur de code
  • Formateur intégré
  • Options du formateur
  • Page Profils et statut

• Editeur de code
  • Menu contextuel de l'éditeur de code
  • Personnalisation de l'éditeur de code