Formatierungsoptionen

Nach oben zu Editor-Optionen

Tools > Optionen > Sprache > Formatierung

Auf den Seiten der Gruppe Formatierung sind die Formatierungsoptionen zum Anpassen des Verhaltens der Quelltextformatierung definiert. Wenn Sie eine Option auswählen, wird Hilfe zu der Option im unteren Bereich der Seite angezeigt.

Hinweis: Die C++-Quelltextformatierung erfolgt über Clang-Format. Die Optionen befinden sich unter Tools > Optionen > Sprache > C++ > Formatierung.

Delphi-Formatierungsoptionen

Zur Formatierung von Delphi-Quelltextdateien werden unterschiedliche Formatierungsoptionssätze verwendet:

• Auf den Seiten unter Delphi können Sie Optionen für Delphi-Projekte mit Delphi-Quelltextdateien mit den folgenden Erweiterungen festlegen: *.pas, *.dpr, *.dpk, *.dpkw, *.inc.

Delphi enthält die Seiten Einzug, Leerzeichen, Zeilenumbrüche, Schreibweise und Ausrichten.

Einzug

Einzugsoptionen	Beschreibung
Einzug bei Zeilenfortsetzung	Definiert einen zusätzlichen Einzug für Fortsetzungszeilen, wenn ein Ausdruck über mehrere Zeilen fortgesetzt wird. Die Vorgabe ist 2.
Nicht weiter einziehen als	Legt die maximale Breite des Einzugs fest, der von der Formatierung eingefügt werden kann. Die Vorgabe ist 40.
Assembly-Abschnitte einziehen	Bei True werden Assembly-Abschnitte wie gewöhnlicher Code eingezogen. Die Vorgabe lautet True.
Schlüsselwörter Begin und End einziehen	Bei True werden die Schlüsselwörter "begin" und "end" eingezogen. Die Vorgabe lautet False.
Blöcke zwischen Begin und End einziehen	Bei True wird der Block zwischen den Schlüsselwörtern "begin" und "end" eingezogen. Die Vorgabe lautet True.
Case-Inhalt einziehen	Bei True wird der Inhalt von case-Anweisungsblöcken (nach case-Labels) relativ zu case-Labels einzogen. Die Vorgabe lautet True.
Case-Labels einziehen	Bei True werden case-Labels relativ zum Schlüsselwort "case" eingezogen. Die Vorgabe lautet True.
Rümpfe von Klassendefinitionen einziehen	Bei True wird ein zusätzlicher Einzug für Abschnitte in Klassendefinitionsrümpfe eingefügt. Member vor dem ersten Abschnitt werden immer eingezogen. Die Vorgabe lautet False.
Einzug für Kommentare	Bei Ja werden Kommentare wie gewöhnliche Anweisungen eingezogen. Die Vorgabe lautet Ja.
Compiler-Direktiven einziehen	Bei True werden Compiler-Direktiven wie gewöhnliche Anweisungen eingezogen. Die Vorgabe lautet False.
Else in case-Anweisungen einziehen	Bei True wird ein zusätzlicher Einzug für "else" in case-Anweisungen eingefügt. Die Vorgabe lautet False.
Funktionsrümpfe einziehen	Bei True wird ein Einzug für Funktions- und Prozedurenrümpfe eingefügt. Die Vorgabe lautet False.
Innere Funktionen einziehen	Bei True wird Code von inneren Funktionen und Prozeduren relativ zum Code der Hauptfunktion und -prozedur eingezogen. Die Vorgabe lautet False
interface-, implementation- und andere Abschnitte einziehen	Bei True wird nach den Schlüsselwörtern "interface", "implementation", "initialization" und "finalization" der Abschnittsinhalt eingezogen. Die Vorgabe lautet False.
Labels einziehen	Legt den Einzug von Labels fest. Die Vorgabe lautet Um einen Einzug verringern.
Verschachtelte eckige und runde Klammern einziehen	Bei True wird ein zusätzlicher Einzug für Fortsetzungszeilen für jede weitere Verschachtelungsebene von eckigen Klammern [] und runden Klammern () eingefügt. Die Vorgabe lautet False.

Leerzeichen

Optionen für Leerzeichen	Beschreibung
Konflikte bei Leerzeichen so lösen	Legt fest, wie mit Leerzeichen an Positionen verfahren wird, für die mehrere widersprüchliche Optionen zutreffen. Die Vorgabe lautet Leerzeichen.
Leerzeichen um Zuweisungsoperatoren festlegen	Legt Leerzeichen um "="-Zuweisungsoperatoren fest. Die Vorgabe lautet Davor und dahinter.
Leerzeichen um binäre Operatoren festlegen	Legt Leerzeichen um binäre mathematische Operatoren fest. Die Vorgabe lautet Davor und dahinter.
Leerzeichen um Doppelpunkte festlegen	Legt Leerzeichen um Doppelpunkte fest. Die Vorgabe lautet Nur dahinter .
Leerzeichen um Doppelpunkte in Formatparametern festlegen	Legt Leerzeichen um den Doppelpunkt im "Format"-Parameter fest. Die Vorgabe lautet Ohne, wodurch keine Leerzeichen eingefügt werden.
Leerzeichen um Kommas festlegen	Legt Leerzeichen um Doppelpunkte fest. Die Vorgabe lautet Nur dahinter .
Leerzeichen um Semikolons festlegen	Legt Leerzeichen um Semikolons fest. Die Vorgabe lautet Nur dahinter .
Leerzeichen um unäre Präfix-Operatoren festlegen	Definiert Leerzeichen um unäre Präfixoperatoren. Die Vorgabe lautet Ohne.
Leerzeichen für //-Kommentare festlegen	Legt Leerzeichen um die Zeichen "//" in Zeilenkommentaren fest. Die Vorgabe lautet Davor und dahinter.
Leerzeichen für { und (* Kommentare festlegen	Bei True werden Compiler-Direktiven wie gewöhnliche Anweisungen eingezogen. Die Vorgabe lautet False.
Else in case-Anweisungen einziehen	Legt Leerzeichen um die öffnenden und schließenden Klammern in Blockkommentaren fest. Die Vorgabe lautet Innere und äußere.
Leerzeichen für runde Klammern festlegen	Bei True wird ein Leerzeichen nach jeder öffnenden und vor jeder schließenden runden Klammer eingefügt. Die Vorgabe lautet False.
Leerzeichen für eckige Klammern festlegen	Bei True wird ein Leerzeichen nach jeder öffnenden und vor jeder schließenden eckigen Klammer eingefügt. Die Vorgabe lautet False.
Leerzeichen in spitzen Klammern in Generics festlegen	Legt innere Leerzeichen für spitze Klammern fest, die in Generics zum Festlegen von Listen mit Typargumenten verwendet werden. Die Vorgabe lautet False.
Leerzeichen vor runden Klammern in Funktionen	Legt Leerzeichen vor runden Klammern in Funktionen und Prozeduren fest. Die Vorgabe lautet Nein.

Zeilenumbruch

Einzugsoptionen	Beschreibung
Zeilenumbrüche des Benutzers beibehalten	Bei True werden im Quelltext vorhandene Zeilenumbrüche beibehalten. Bei False werden vorhandene Zeilenumbrüche ignoriert. Die Vorgabe lautet False.
Zeilenumbruch nach Begin	Legt fest, ob ein Zeilenumbruch nach jedem Schlüsselwort "begin" eingefügt wird. Die Vorgabe lautet Ja.
Zeilenumbruch nach Labels	Legt fest, ob Zeilenumbrüche nach Labels eingefügt werden. Die Vorgabe lautet Ja.
Zeilenumbruchzeichen	Legt die Zeichen fest, die als Zeilenumbruch eingefügt werden.
Zeilenumbruch in 'Else If'	Legt fest, ob Zeilenumbrüche zwischen "else" und "if" in verschachtelten if-Anweisungen eingefügt werden. Die Vorgabe lautet False.
Zeilenumbrüche nach Begin in Steueranweisungen	Legt fest, ob Zeilenumbrüche nach "begin" in Bedingungsanweisungen und Schleifenanweisungen eingefügt werden. Die Vorgabe lautet Ja.
Zeilenumbrüche nach Begin in Methodendefinitionen	Legt fest, ob Zeilenumbrüche nach dem Schlüsselwort "begin" in Methodendefinitionen eingefügt werden. Die Vorgabe lautet Ja.
Zeilenumbrüche nach Semikolons	Legt fest, ob Zeilenumbrüche nach jedem Semikolon eingefügt werden. Die Vorgabe lautet True.
Zeilenumbrüche nach Uses-Schlüsselwörtern	Legt fest, ob Zeilenumbrüche nach den Schlüsselwörtern Uses, Label, Export, Requires und Contains eingefügt werden. Die Vorgabe lautet Wie vorhanden.
Zeilenumbrüche vor Begin in Steueranweisungen	Legt fest, ob Zeilenumbrüche vor "begin" in Bedingungsanweisungen und Schleifenanweisungen eingefügt werden. Die Vorgabe lautet Ja.
Zeilenumbrüche vor Einzelanweisungen in Steueranweisungen	Legt fest, ob Zeilenumbrüche vor Einzelanweisungen in Bedingungsanweisungen und Schleifenanweisungen eingefügt werden. Die Vorgabe lautet Ja.
Zeilenumbrüche vor Einzelanweisungen in try-except-Blöcken	Legt fest, ob Zeilenumbrüche vor Einzelanweisungen in "try-except"- und "try-finally"-Blöcken eingefügt werden. Die Vorgabe lautet Ja.
Zeilenumbrüche vor Then	Legt die Position des Schlüsselwortes "then" in if-Anweisungen fest. Die Vorgabe lautet False.
Zeilenumbrüche in anonymen Funktionszuweisungen	Legt fest, ob Zeilenumbrüche in Zuweisungen anonymer Funktionen eingefügt werden. Die Vorgabe lautet False.
Zeilenumbrüche in anonymen Funktionsverwendungen	Legt fest, ob Zeilenumbrüche in Verwendungen anonymer Funktionen eingefügt werden. Die Vorgabe lautet False.
Zeilenumbrüche in Array-Initialisierungen	Steuert Zeilenumbrüche in Array-Initialisierungen. Die Vorgabe lautet Ja.
Zeilenumbrüche in Vererbungslisten	Legt die Position von Basisklassen und -Interfaces in Vererbungslisten fest. Die Vorgabe lautet Nein.
Zeilenumbrüche in Label-, Export-, Requires-, Contains-Klauseln	Legt fest, ob Zeilenumbrüche vor dem Element in Label-, Export-, Requires- und Contains-Klauseln einfügt werden. Die Vorgabe lautet Nein.
Zeilenumbrüche in Eigenschaftsdeklarationen	Legt fest, ob Zeilenumbrüche vor den Schlüsselwörtern "read", "write", "stored" und "default" in Eigenschaftsdeklarationen eingefügt werden. Die Vorgabe lautet False.
Zeilenumbrüche in Uses-Klauseln	Legt fest, ob Zeilenumbrüche vor jedem Element in Uses-Klauseln eingefügt werden. Die Vorgabe lautet Wie vorhanden.
Zeilenumbruch in Var- und Const-Abschnitten	Legt fest, ob Zeilenumbrüche vor jedem Element in Var- und Const-Abschnitte einfügt werden. Die Vorgabe lautet Ja.
Maximale Anzahl aufeinanderfolgender Leerzeilen	Legt die maximale Anzahl aufeinanderfolgender, benutzerdefinierter Leerzeilen im Code fest. Die Vorgabe ist 1.
Neue Zeile für einen Funktionsrückgabetyp	Legt die Position des Rückgabetyps in Funktionsdeklarationen und -definitionen fest. Die Vorgabe lautet Nein.
Anzahl der Leerzeilen um Compiler-Direktiven	Legt die Anzahl der als Trennlinien verwendeten Leerzeilen um Compiler-Direktiven fest. Die Vorgabe ist 0.
Anzahl der Leerzeilen um Abschnittsschlüsselwörter	Legt die Anzahl der als Trennlinien verwendeten Leerzeilen um "interface"-, "implementation"- und andere Schlüsselwörter fest, die Abschnitte einleiten. Die Vorgabe ist 1.
Anzahl der Leerzeilen als Trennlinien im implementation-Abschnitt	Legt die Anzahl der als Trennlinien verwendeten Leerzeilen in implementation-Abschnitten fest. Die Vorgabe ist 1.
Anzahl der Leerzeilen als Trennlinien im interface-Abschnitt	Legt die Anzahl der als Trennlinien verwendeten Leerzeilen in interface-Abschnitten fest. Die Vorgabe ist 1.
Anzahl der Leerzeilen vor Unterabschnitten	Legt die Anzahl der als Trennlinien verwendeten Leerzeilen vor "Var"-, "Const"-, "Label"- und anderen Unterabschnitten fest. Die Vorgabe ist 1.
Anzahl der Leerzeilen vor dem Schlüsselwort Type	Legt die Anzahl der als Trennlinien verwendeten Leerzeilen vor dem Schlüsselwort "type" fest. Die Vorgabe ist 1.
Anzahl der Leerzeilen vor Sichtbarkeitsmodifizierern	Legt die Anzahl der als Trennlinien verwendeten Leerzeilen vor Sichtbarkeitsmodifizierern fest. Die Vorgabe ist 0.
Einen Parameter pro Zeile in Funktionsaufrufen	Legt die Position von Parameterwerten in Funktions-/Prozedurenaufrufen fest. Die Vorgabe lautet Nein.
Einen Parameter pro Zeile in Funktionsdefinitionen	Legt die Position von Parametern in Funktions- und Prozedurendeklarationen und -definitionen fest. Die Vorgabe lautet Nein.
Zeilenumbrüche in 'End Else Begin' entfernen	Legt fest, ob Zeilenumbrüche in "End-Else-Begin"-Konstruktionen entfernt werden. Die Vorgabe lautet False.
Zeilenumbrüche in 'End Else If' entfernen	Legt fest, ob Zeilenumbrüche in "End-Else-If"-Konstruktionen entfernt werden. Die Vorgabe lautet False.
Rechter Rand	Legt den rechten Rand fest, an dem Codezeilen umbrochen werden. Die Vorgabe ist 80.
Quelltext kürzen	Steuert das Entfernen von Whitespaces (Leerzeichen, Tabulatoren und Zeilenumbrüche) am Anfang und am Ende der Datei. Die Vorgabe lautet True.

Schreibweise

Einzugsoptionen	Beschreibung
Großschreibung von Compiler-Direktiven	Legt die Großschreibung von Compiler-Direktiven fest. Die Vorgabe lautet GROSSBUCHSTABEN.
Großschreibung von Zahlen	Legt die Großschreibung von Buchstaben in hexadezimalen und Gleitkommazahlen, einschließlich von Zeichen in Präfixen und Suffixen, fest. Die Vorgabe lautet GROSSBUCHSTABEN.
Großschreibung sonstiger Wörter	Legt die Großschreibung für Wörter fest, die zu den anderen Gruppen gehören. Die Vorgabe lautet Wie erstes Vorkommen.
Großschreibung von reservierten Wörtern und Direktiven	Legt die Großschreibung von reservierten Wörtern und Direktiven fest. Die Vorgabe lautet Wie vorhanden.

Ausrichten

Einzugsoptionen	Beschreibung
":" vor Typnamen ausrichten	Legt fest, ob Doppelpunkte ":" vor Typnamen ausgerichtet werden. Die Vorgabe lautet False.
"=" in Konstanten ausrichten	Richtet Zuweisungsoperatoren in Konstanteninitialisierungen aus. Die Vorgabe lautet False.
"=" in Initialisierungen ausrichten	Richtet Zuweisungsoperatoren in Initialisierungen aus. Die Vorgabe lautet False.
"=" in Typdeklarationen ausrichten	Richtet "=" in Typdeklarationen aus. Die Vorgabe lautet False.
Zuweisungsoperatoren ausrichten	Richtet Zuweisungsoperatoren aus. Die Vorgabe lautet False.
Zeilenendekommentare ausrichten	Richtet Kommentare am Ende von Zeilen aus. Die Vorgabe lautet False.
Felder in Eigenschaften ausrichten	Richtet Felder in Eigenschaften aus. Die Vorgabe lautet False.
Typnamen ausrichten	Richtet Typnamen in var-Abschnitten und Records aus. Die Vorgabe lautet False.
Parametertypen ausrichten	Richtet Parametertypen aus. Die Vorgabe lautet False.
Maximale Spaltenausrichtung	Fügt nach der angegebenen Spalte keine Leerzeichen für die Ausrichtung ein. Die Vorgabe ist 60.
Maximal nicht ausgerichtete Zeilen	Die zulässige Maximalanzahl fortlaufender, nicht ausgerichteter Codezeilen, ohne dass der Ausrichtungsblock beendet wird. Die Vorgabe lautet False.

Seite "Profile und Status"

Auf der Seite Profile und Status können Sie Formatierungsoptionssätze verwalten, die Quelltextformatierung aktivieren und festlegen, dass vor Ausführung der Formatierungsbefehle, eine Aufforderung zur Bestätigung angezeigt wird.

Formatierungsoptionen verwalten

Die Quelltextformatierung stellt mehrere vordefinierte Formatierungsoptionssätze zur Verfügung. Mit Profil auswählen können Sie den aktiven Satz auswählen. Der in dem ausgewählten Formatierungsprofil (Konfigurationsdatei) gespeicherte Formatierungsoptionssatz wird als aktueller Optionssatz für die Formatierung verwendet.

Sie können den aktiven Optionssatz individuell anpassen und ihn mit Speichern unter in einer Formatierungskonfigurationsdatei speichern. Später kann dann dieser (in einer Konfigurationsdatei gespeicherte) Optionssatz mit Laden geladen werden.

Formatierungsverhalten verwalten

Die Optionen in der Gruppe Formatierungsstatus definieren das Verhalten der Formatierung:

• Formatierung aktivieren: Wählen Sie diese Option aus, um die Formatierung zu aktivieren. Wenn diese Option nicht ausgewählt ist, dann werden alle Menübefehle zur Formatierung von Quelltextdateien verborgen und sind nicht verfügbar.
• Bestätigung anzeigen: Ist diese Option ausgewählt, wird eine Aufforderung zur Bestätigung angezeigt, wenn Sie versuchen, einen Formatierungsbefehl zu aktivieren.

Von der Formatierung verwendete Editor-Optionen

Die Quelltextformatierung verwendet die Optionen Einzug mit Tab, Einrückung und Tabstopps, die auf der Seite Quelloptionen (Editor-Optionen > Quelloptionen) des Dialogfeldes Optionen definiert sind.

• Wählen Sie zum Festlegen dieser Optionen für Delphi in der Liste Quelldateityp Pascal aus.
• Wählen Sie zum Festlegen dieser Optionen für C++ in der Liste Quelldateityp C/C++ aus.

Siehe auch

• Quelltext formatieren
• Quelltextformatierung
  • Integrierte Formatierung
  • Formatter.EXE: Die Befehlszeilen-Formatierung
  • Profile und Status (Seite)
• Quelltext-Editor
  • Kontextmenü des Quelltext-Editors
  • Editor-Optionen (Seite)