Quelltext formatieren

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu So bearbeiten Sie Code im Quelltext-Editor


Bei der Bearbeitung von Delphi- oder C++-Code im Quelltext-Editor können Sie mit dem Kontextmenübefehl Quelltext formatieren den Quelltext formatieren. In der Gruppe Formatierung des Dialogfelds Optionen (Tools > Optionen > Sprache > Formatierung) sind die Formatierungsoptionen Einzug, Leerzeichen, Zeilenumbrüche und Ausrichtung verfügbar. In den Gruppen Delphi und C++ können Sie unterschiedliche Formatierungsoptionssätze für Delphi- und C++-Quelltextdateien festlegen.

Beachten Sie, dass die Quelltextformatierung nur die festgelegten Formatierungsoptionen berücksichtigt. Alle manuell im Quelltext-Editor vorgenommenen Formatierungen werden überschrieben.

So aktivieren Sie die Formatierung:

  1. Klicken Sie auf Tools > Optionen > Sprache > Formatierung.
  2. Erweitern Sie in der Struktur im linken Bereich des Dialogfelds Optionen den Knoten Formatierung.
  3. Wählen Sie den Knoten Profile und Status aus – die Seite Formatierungsprofile und Status wird geöffnet.
  4. Wählen Sie Formatierung aktivieren aus.
  5. Klicken Sie auf OK. Dadurch werden die Befehle für die Quelltextformatierung aktiviert. Das heißt, dass die Befehle Quelltext formatieren und Projektquellen formatieren in den entsprechenden Menüs (und Kontextmenüs) angezeigt werden und verfügbar sind.
Auf der Seite Profile und Status können Sie auch Formatierungsoptionssätze verwalten (mithilfe von Konfigurationsdateien, in denen die Formatierungsoptionen gespeichert sind) und die Aufforderung zur Bestätigung aktivieren oder deaktivieren, die vor Ausführung der Formatierung angezeigt wird.

So legen Sie Formatierungsoptionen fest:

  1. Klicken Sie auf Tools > Optionen > Sprache > Formatierung.
  2. Erweitern Sie in der Struktur im linken Bereich des Dialogfelds Optionen den Knoten Formatierung. Die Delphi-Unterstrukturen werden geöffnet.
    • Die C++-Optionen werden in C++-Projekten zur Formatierung von C/C++-Quelltextdateien mit den folgenden Erweiterungen verwendet: *.cpp, *.cxx, *.cc, *.c, *.hpp, *.hxx, *.hh, *.h. Weitere Informationen finden Sie unter Formatierung.
    • Delphi enthält die Optionsgruppen Einzug, Leerzeichen, Zeilenumbrüche, Schreibweise und Ausrichtung. Die Delphi-Optionen werden in Delphi-Projekten zur Formatierung von Delphi-Quelltextdateien mit den folgenden Erweiterungen verwendet: *.pas, *.dpr, *.dpk, *.dpkw, *.inc.
  3. Wählen Sie eine Optionsgruppe aus. Im rechten Bereich werden daraufhin die Optionen der ausgewählten Gruppe angezeigt.
  4. Wählen Sie eine beliebige Option aus. Unten im rechten Fensterbereich wird eine detaillierte Beschreibung der jeweiligen Option angezeigt.
  5. Um einen Optionswert zu ändern (oder um alle verfügbaren Werte einer Option anzuzeigen), klicken Sie in die rechte Spalte der Optionszeile und dann auf den nach unten weisenden Pfeil. Die Liste mit den verfügbaren Werten wird angezeigt.
  6. Wählen Sie den gewünschten Wert aus.
  7. Klicken Sie auf OK. Der festgelegte Satz von Formatierungsoptionen wird daraufhin von der Quelltextformatierung verwendet.

So formatieren Sie die Quelltextdatei:

  1. Öffnen Sie im Quelltext-Editor die Delphi- oder C++-Quelltextdatei.
  2. Wählen Sie die gewünschten Formatierungsoptionen aus (falls erforderlich).
  3. Klicken Sie mit der rechten Maustaste in den Quelltext-Editor, und wählen Sie im Kontextmenü den Befehl Quelltext formatieren aus (oder klicken Sie auf den Menübefehl Bearbeiten > Quelltext formatieren.)
  4. Wenn das Dialogfeld Bestätigung angezeigt wird, klicken Sie auf Ja.
  5. Der Quelltext-Editor wird aktualisiert und enthält nun den mit den ausgewählten Optionen formatierten Quelltext.

So formatieren Sie einen Quelltextblock:

  1. Öffnen Sie im Quelltext-Editor die Delphi- oder C++-Quelltextdatei.
  2. Wählen Sie die gewünschten Formatierungsoptionen aus (falls erforderlich).
  3. Wählen Sie einen Codeblock aus.
  4. Klicken Sie mit der rechten Maustaste in den markierten Codeblock, und wählen Sie im Kontextmenü den Befehl Quelltext formatieren aus (oder klicken Sie auf den Menübefehl Bearbeiten > Quelltext formatieren).
  5. Wenn das Dialogfeld Bestätigung angezeigt wird, klicken Sie auf Ja.
  6. Der Quelltext-Editor wird aktualisiert und enthält nun den mit den ausgewählten Optionen formatierten Codeblock. Nur die Formatierung des ausgewählten Blocks wird aktualisiert.

So formatieren Sie die Quelltextdateien in einem Projekt:

  1. Aktivieren Sie in der Projektverwaltung ein Projekt.
  2. Führen Sie den Befehl Projektquellen formatieren aus:
    • Klicken Sie dazu mit der rechten Maustaste in die Projektverwaltung, und wählen Sie den Kontextmenübefehl Projektquellen formatieren aus oder
    • Wählen Sie den Menübefehl Projekt > Projektquellen formatieren aus.
  3. Klicken Sie im angezeigten Bestätigungsdialogfeld Projektquellen formatieren auf OK.

Die Quellen aller Quelltextdateien in diesem Projekt werden formatiert und die Dateien mit dem geänderten Quellcode aktualisiert.

So verwenden Sie Formatierungsprofile:

  1. Klicken Sie auf Tools > Optionen > Sprache > Formatierung.
  2. Erweitern Sie in der Struktur im linken Bereich des Dialogfelds Optionen den Knoten Formatierung.
  3. Wählen Sie den Knoten Profile und Status aus. Die Seite Formatierungsprofile und Status wird geöffnet.
  4. Klicken Sie in der Gruppe Profil auswählen auf Profile, um die Liste der verfügbaren Profile anzuzeigen und ein Profil auszuwählen. Der Name des ausgewählten Profils wird in Profile angezeigt.
Profile sind spezielle Dateien zum Speichern von Formatierungsoptionen. Damit eine Datei in der Liste Profile angezeigt wird, muss sie folgende Voraussetzungen erfüllen:
  • Der Dateimaske Formatter_*.config entsprechen.
  • Im Arbeitsverzeichnis von RAD Studio vorhanden sein: C:\Users\<Benutzername>\AppData\Roaming\Embarcadero\BDS\23.0.
Der Standardprofilsatz enthält die Profile Formatter_Compact.config, Formatter_Default.config und Formatter_Wide.config.
Sätze mit Formatierungsoptionen, die in Profilen gespeichert sind, können als Formatierungsprofile behandelt werden.
  1. Klicken Sie auf Übernehmen. Der Satz der in dem ausgewählten Profil gespeicherten Formatierungsoptionen wird nun von der Formatierung verwendet. Mit anderen Worten: Das Formatierungsprofil wurde aus dem ausgewählten Profil geladen.

So speichern Sie einen individuell angepassten Satz mit Formatierungsoptionen in einer Datei:

  1. Klicken Sie auf Tools > Optionen > Sprache > Formatierung.
  2. Erweitern Sie in der Struktur im linken Bereich des Dialogfelds Optionen den Knoten Formatierung. Passen Sie die Formatierungsoptionen an, wie im Abschnitt So legen Sie Formatierungsoptionen fest beschrieben.
  3. Wählen Sie den Knoten Profile und Status aus. Die Seite Formatierungsprofile und Status wird geöffnet. Klicken Sie auf Speichern unter. Das Dialogfeld Formatierungsprofil speichern wird angezeigt.
    • Standardmäßig wird in diesem Dialogfeld vorgeschlagen, eine Datei im Arbeitsverzeichnis von RAD Studio zu speichern.
    • Als Dateityp-Filter wird standardmäßig die Dateimaske Profile (Formatter_*.config) verwendet.
  4. Geben Sie in das Feld Dateiname den Namen der Datei ein, in die der aktuelle Satz der Formatierungsoptionen gespeichert werden soll.
  5. Klicken Sie auf Speichern.
Ihr angepasster Formatierungsoptionssatz wird in der angegebenen Datei gespeichert.

So laden Sie einen Formatierungsoptionsatz aus einer Datei:

  1. Klicken Sie auf Tools > Optionen > Sprache > Formatierung.
  2. Erweitern Sie in der Struktur im linken Bereich des Dialogfelds Optionen den Knoten Formatierung.
  3. Wählen Sie den Knoten Profile und Status aus. Die Seite Formatierungsprofile und Status wird geöffnet. Klicken Sie auf Laden. Das Dialogfeld Formatierungsprofil laden wird angezeigt.
    • Standardmäßig wird in diesem Dialogfeld vorgeschlagen, eine Datei aus dem Arbeitsverzeichnis von RAD Studio zu laden.
    • Als Dateityp-Filter wird standardmäßig die Dateimaske Profile (Formatter_*.config) verwendet.
Die Dateien mit dieser Maske im Arbeitsverzeichnis von RAD Studio sind sogenannte Profile. Daher werden standardmäßig in der Dateiliste im Hauptbereich nur vorhandene Profile angezeigt. Zum Anzeigen anderer Dateien, in denen Formatierungsoptionen gespeichert sind, wählen Sie im Filter Dateityp die Option Config-Dateien (*.config) aus.
  1. Geben Sie in das Feld Dateiname den Namen der Datei ein, aus der der gespeicherte Formatierungsoptionssatz geladen werden soll.
  2. Klicken Sie auf Öffnen. Der Satz der in der angegebenen Datei gespeicherten Formatierungsoptionen wird geladen und als aktueller Formatierungsoptionssatz verwendet.

Siehe auch