Options du formateur

Remonter à Options du langage

Outils > Options > Langage > Formateur

Les pages du groupe Formateur définissent les options du formateur qui personnalisent le comportement du formateur de code source. Lorsque vous sélectionnez une option, l'aide relative à cette option s'affiche dans le volet inférieur de la page.

Remarque: Le formatage de code C++ est effectué par clang-format et les options associées sont accessibles dans Outils > Options > Langage > C++ > Formatage.

Options de formatage Delphi

Différents jeux d'options de formatage sont utilisés pour formater les fichiers de code source Delphi :

• Dans les pages situées sous Delphi, vous pouvez définir les options à utiliser dans les projets Delphi pour les fichiers de code source Delphi avec les extensions suivantes : *.pas, *.dpr, *.dpk, *.dpkw, *.inc.

Delphi contient les pages Indentation, Espaces, Sauts de ligne, Capitalisation et Aligner.

Indentation

Options d'indentation	Description
Retrait de continuation	Définit l'indentation supplémentaire qui est ajoutée pour les lignes de continuation quand une expression se poursuit sur plusieurs lignes. La valeur par défaut est 2.
Ne pas indenter après la position spécifiée	Définit la largeur maximale de l'indentation, qui peut être insérée par le formateur. La valeur par défaut est 40.
Indenter les sections d'assemblage	Si cette option est définie sur True, les sections d'assemblage sont indentées comme du code habituel. La valeur par défaut est True.
Indenter les mots clés Begin et End	Si cette option est définie sur True, les mots clés "begin" et "end" sont indentés. La valeur par défaut est False.
Indenter les blocs entre Begin et End	Si cette option est définie sur True, le contenu des blocs entre les mots clés "begin" et "end" est indenté. La valeur par défaut est True.
Indenter le contenu du Case	Si cette option est définie sur True le contenu des blocs d'instruction case est indenté (après les libellés case) relativement aux libellés case. La valeur par défaut est True.
Indenter les libellés case	Si cette option est définie sur True, les libellés case sont indentés relativement au mot clé "case". La valeur par défaut est True.
Indenter les corps des définitions de classes	Si cette option est définie sur True, une indentation supplémentaire est insérée pour les sections dans les corps de définition de classe. Les membres situés avant la première section sont toujours indentés. La valeur par défaut est False.
Indenter les commentaires	Si cette option est définie sur Oui, les commentaires sont indentés comme des instructions habituelles. La valeur par défaut est Oui.
Indenter les directives du compilateur	Si cette option est définie sur True, les directives du compilateur sont indentées comme des instructions habituelles. La valeur par défaut est False.
Indenter Else dans les instructions case	Si cette option est définie sur True, une indentation supplémentaire "Else" est ajoutée dans les instructions case. La valeur par défaut est False.
Indenter les corps des fonctions	Si cette option est définie sur True, une indentation est ajoutée aux corps des fonctions et procédures. La valeur par défaut est False.
Indenter les fonctions internes	Si cette option est définie sur True, le code des fonctions et procédures internes est indenté relativement au code de la fonction et procédure principales. La valeur par défaut est False.
Indenter les sections interface, implementation, et les autres sections	Si cette option est définie sur True, une indentation est ajoutée au contenu de la section après les mots clés "interface", "implementation" et "finalization". La valeur par défaut est False.
Indenter les libellés	Définit l'indentation des libellés. La valeur par défaut est définie sur Réduire d'un retrait.
Indenter les parenthèses et les crochets imbriqués	Si cette option est définie sur True, une indentation supplémentaire est insérée pour les lignes de continuation à chaque niveau d'imbrication supplémentaire des crochets [] et des parenthèses (). La valeur par défaut est False.

Espaces

Options d'espace	Description
Résoudre les conflits d'espacement	Définit comment gérer les espaces dans des positions contrôlées par plusieurs options en conflit. La valeur par défaut est Espace.
Définir l'espacement autour des opérateurs d'affectation	Définit l'espace autour des opérateurs d'affectation '='. La valeur par défaut est Avant et après.
Définir l'espacement autour des opérateurs binaires	Définit les espaces autour des opérateurs mathématiques binaires. La valeur par défaut est Avant et après.
Définir l'espacement autour des deux-points	Définit les espaces autour des deux-points. La valeur par défaut est Après seulement.
Définir l'espacement autour des deux-points dans le format	Définit les espaces autour des deux-points dans les paramètres de format. La valeur par défaut est Aucun qui n'insère pas d'espaces.
Définir l'espacement autour des virgules	Définit les espaces autour des deux-points. La valeur par défaut est Après seulement.
Définir l'espacement autour des points-virgules	Définit les espaces autour des points-virgules. La valeur par défaut est Après seulement.
Définir l'espacement autour des opérateurs préfixes unaires	Définit les espaces autour des opérateurs préfixes unaires. La valeur par défaut est Aucun.
Définir l'espacement des commentaires //	Définit les espaces autour du token // dans les commentaires de lignes. La valeur par défaut est Avant et après.
Définir l'espacement des commentaires { et (*	Si cette option est définie sur True, les directives du compilateur sont indentées comme des instructions habituelles. La valeur par défaut est False.
Indenter Else dans les instructions case	Définit les espaces autour des accolades ouvrantes, fermantes, ou dans les commentaires de blocs. La valeur par défaut est Interne et externe.
Définir l'espacement des parenthèses	Si cette option est définie sur True, un espace est inséré après chaque parenthèse ouvrante et avant chaque parenthèse fermante. La valeur par défaut est False.
Définir l'espacement des crochets	Si cette option est définie sur True, un espace est inséré après chaque crochet ouvrant et avant chaque crochet fermant. La valeur par défaut est False.
Définir l'espacement à l'intérieur des crochets angulaires dans les génériques	Définit l'espacement à l'intérieur des crochets angulaires utilisés dans les génériques pour spécifier les listes d'arguments de type. La valeur par défaut est False.
Espaces avant les parenthèses dans les fonctions	Définit les espaces avant une parenthèse dans les fonctions et les procédures. La valeur par défaut est Non.

Saut de ligne

Options d'indentation	Description
Conserver les sauts de ligne utilisateur	Si cette option est définie sur True, les sauts de ligne existants sont conservés dans le code source. Si elle est définie sur False, les sauts de ligne existants sont ignorés. La valeur par défaut est False.
Saut de ligne après Begin	Définit s'il faut insérer un saut de ligne après chaque mot clé "begin". La valeur par défaut est Oui.
Saut de ligne après un libellé	Définit s'il faut insérer des sauts de ligne après les libellés. La valeur par défaut est Oui.
Caractères saut de ligne	Définit les caractères qui seront insérés en tant que sauts de ligne.
Saut de ligne dans "Else If"	Définit s'il faut insérer des sauts de ligne entre "else" et "if" dans les instructions "if" imbriquées. La valeur par défaut est False.
Sauts de ligne après Begin dans les instructions de contrôle	Définit s'il faut insérer des sauts de ligne après "begin" dans les instructions conditionnelles et dans les instructions de boucle. La valeur par défaut est Oui.
Sauts de ligne après Begin dans les définitions de méthodes	Définit s'il faut insérer des sauts de ligne après le mot clé "begin" dans les définitions de méthodes. La valeur par défaut est Oui.
Sauts de ligne après les points-virgules	Définit s'il faut insérer un saut de ligne après chaque point-virgule. La valeur par défaut est True.
Sauts de ligne après les mots clés Uses	Définit s'il faut insérer des sauts de ligne après les mots clés Uses, Label, Export, Requires et Contains. La valeur par défaut est Tel quel.
Sauts de ligne avant Begin dans les instructions de contrôle	Définit s'il faut insérer des sauts de ligne avant "begin" dans les instructions conditionnelles et dans les instructions de boucle. La valeur par défaut est Oui.
Sauts de ligne avant les instructions simples dans les instructions de contrôle	Définit s'il faut insérer des sauts de ligne avant les instructions simples dans les instructions conditionnelles et dans les instructions de boucle. La valeur par défaut est Oui.
Sauts de ligne avant les instructions simples dans les blocs try-except	Définit s'il faut insérer des sauts de ligne avant les instructions simples dans les blocs "try-except" et "try-finally". La valeur par défaut est Oui.
Sauts de ligne avant Then	Définit le positionnement des mots clés "then" dans les instructions "if". La valeur par défaut est False.
Sauts de ligne dans les affectations de fonctions anonymes	Définit s'il faut insérer des sauts de ligne dans les affectations de fonctions anonymes. La valeur par défaut est False.
Sauts de ligne dans l'usage de fonctions anonymes	Définit s'il faut insérer des sauts de ligne dans l'usage de fonctions anonymes. La valeur par défaut est True.
Sauts de ligne dans les initialisations des tableaux	Contrôle les sauts de ligne dans les initialisations des tableaux. La valeur par défaut est Oui.
Sauts de ligne dans les listes d'héritage	Définit le positionnement des classes de base et des interfaces dans les listes d'héritage. La valeur par défaut est Non.
Sauts de ligne dans les clauses Label, Export, Requires, Contains	Définit s'il faut insérer des sauts de ligne avant l'élément dans les clauses Label, Export, Requires, Contains. La valeur par défaut est Non.
Sauts de lignes dans les déclarations des propriétés	Définit s'il faut insérer des sauts de ligne avant chaque mot clé "read", "write", "stored", "default" dans les déclarations des propriétés. La valeur par défaut est False.
Sauts de ligne dans les clauses Uses	Définit s'il faut insérer des sauts de ligne avant chaque élément dans les clauses Uses. La valeur par défaut est Tel quel.
Sauts de ligne dans les sections Var et Const	Définit s'il faut insérer des sauts de ligne avant chaque élément dans les sections Var et Const. La valeur par défaut est Oui.
Nombre maximal de lignes vides adjacentes	Définit le nombre maximal de lignes vides adjacentes définies par l'utilisateur dans le code. La valeur par défaut est 1.
Nouvelle ligne pour un type de retour de fonction	Définit le positionnement du type de retour dans une déclaration et une définition de fonction. La valeur par défaut est Non.
Nombre de lignes vides autour des directives du compilateur	Définit le nombre de lignes vides utilisées comme séparateurs autour des directives du compilateur. La valeur par défaut est 0.
Nombre de lignes vides autour des mots clés de section	Définit le nombre de lignes vides utilisées comme séparateurs autour des mots clés "Interface", "Implementation" et autres dans les sections ouvertes. La valeur par défaut est 1.
Nombre de lignes vides comme séparateur dans la section Implementation	Définit le nombre de lignes vides utilisées comme séparateurs dans les sections Implementation. La valeur par défaut est 1.
Nombre de lignes vides comme séparateur dans la section Interface	Définit le nombre de lignes vides utilisées comme séparateurs dans les sections interface. La valeur par défaut est 1.
Nombre de lignes vides avant les sous-sections	Définit le nombre de lignes vides utilisées comme séparateurs avant les sous-sections "Var", "Const", "Label" et autres. La valeur par défaut est 1.
Nombre de lignes vides avant le mot clé Type	Définit le nombre de lignes vides utilisées comme séparateurs avant les mots clés "type". La valeur par défaut est 1.
Nombre de lignes vides avant les modificateurs de visibilité	Définit le nombre de lignes vides utilisées comme séparateurs avant les modificateurs de visibilité. La valeur par défaut est 0.
Un paramètre par ligne dans les appels de fonctions	Définit le positionnement des valeurs de paramètres dans les appels de fonction/procédure. La valeur par défaut est Non.
Un paramètre par ligne dans les définitions des fonctions	Définit le positionnement des paramètres dans les déclarations et définitions des fonctions et procédures. La valeur par défaut est Non.
Retirer les sauts de ligne dans "End Else Begin"	Définit s'il faut retirer les sauts de ligne dans les constructions "End Else Begin". La valeur par défaut est False.
Retirer les sauts de ligne à l'intérieur "End Else If"	Définit s'il faut retirer les sauts de ligne dans les constructions "End Else If". La valeur par défaut est False.
Marge droite	Définit la marge droite pour séparer les lignes de code. La valeur par défaut est 80.
Retirer les espaces du source	Contrôle le retrait des espaces blancs (espaces, tabulations et sauts de ligne) au début et à la fin du fichier. La valeur par défaut est True.

Capitalisation

Options d'indentation	Description
Capitalisation des directives du compilateur	Définit la capitalisation des directives du compilateur. La valeur par défaut est MAJUSCULE.
Capitalisation des nombres	Définit la capitalisation des lettres utilisées dans les nombres hexadécimaux et flottants, notamment les caractères dans les préfixes et les suffixes. La valeur par défaut est MAJUSCULE.
Capitalisation des autres mots	Définit comment capitaliser les autres mots. La valeur par défaut est Comme première occurrence.
Capitalisation des mots réservés et des directives	Définit la capitalisation des mots réservés et des directives. La valeur par défaut est Tel quel.

Aligner

Options d'indentation	Description
Aligner ":" avant les noms des types	Définit s'il faut aligner les deux points avant les noms de type. La valeur par défaut est False.
Aligner les "=" dans les constantes	Aligne les opérateurs d'affectation dans les initialisations de constantes. La valeur par défaut est False.
Aligner les "=" dans les initialisations	Aligne les opérateurs d'affectation dans les initialisations. La valeur par défaut est False.
Aligner les "=" dans les déclarations des types	Aligne "=" dans les déclarations de type. La valeur par défaut est False.
Aligner les opérateurs d’affectation	Aligne les opérateurs d’affectation. La valeur par défaut est False.
Aligner les commentaires fin-de-ligne	Aligne les commentaires situés aux fins de lignes. La valeur par défaut est False.
Aligner les champs dans les propriétés	Aligne les champs et les méthodes dans les propriétés. La valeur par défaut est False.
Aligner les noms des types	Aligne les noms de types dans les enregistrements et les sections var. La valeur par défaut est False.
Aligner les types des paramètres	Aligne les types de paramètres. La valeur par défaut est False.
Colonne maximale d'alignement	N'insère pas d'espaces d'alignement après la colonne spécifiée. La valeur par défaut est 60.
Lignes non alignées maximales	Le nombre maximal de lignes de code non alignées cohérentes, autorisé sans terminer un bloc d'alignement de lignes. La valeur par défaut est False.

Page Profils et statuts

Dans la page Profils et statuts, vous pouvez gérer les jeux d'options du formateur, activer le formateur de code source et activer le message d'invite de confirmation avant les commandes de formatage.

Gestion des jeux d'options du formateur

Le formateur de code source comporte plusieurs jeux prédéfinis d'options de formatage. Vous pouvez sélectionner le jeu actif avec Sélectionner un profil. Le jeu d'options de formatage stocké dans le profil de formateur sélectionné (fichier de configuration) devient alors le jeu d'options actuellement utilisé pour le formateur.

Vous pouvez personnaliser le jeu actif d'options et l'enregistrer dans un fichier de configuration du formateur avec Enregistrer sous. Vous pourrez charger par la suite le jeu d'options (stocké dans un fichier de configuration) avec Charger.

Gestion du comportement du formateur

Les options du groupe Statut du formateur définissent le comportement du formateur :

• Activer le formateur -- Sélectionnez cette option pour activer le formateur. Si cette option n'est pas sélectionnée, toutes les commandes de menu responsables du formatage des fichiers de code source deviennent masquées et inaccessibles.
• Afficher la boîte de dialogue de confirmation -- Si cette case à cocher est sélectionnée, le message d'invite de confirmation apparaît chaque fois que vous essayez d'activer une commande de formatage.

Options de l'éditeur utilisées par le formateur

Le formateur du code source utilise les options Utiliser les caractères de tabulation, Indentation de bloc et Arrêts tabulation qui sont définies dans la page Options du source(Options de l'éditeur > Options du source) de la boîte de dialogue Options.

• Pour définir ces options pour Delphi, sélectionnez Pascal dans Fichier source.
• Pour définir ces options pour C++, sélectionnez C/C++ dans Fichier source.

Voir aussi

• Formatage du code source
• Formateur de code
  • Formateur intégré
  • Formatter.EXE, le formateur en ligne de commande
  • Page Profils et statuts
• Editeur de code
  • Menu contextuel de l'éditeur de code
  • Page Options de l'éditeur