Quelltext-Editor

Aus Appmethod Topics
Wechseln zu: Navigation, Suche

Nach oben zu Verwenden des Quelltext-Editors und der IDE

Der Quelltext-Editor und der Formular-Designer befinden sich im mittleren Bereich des IDE-Fensters. Der Quelltext-Editor ist ein leistungsstarker, konfigurierbarer UTF8-Editor mit Funktionen wie Syntaxhervorhebung, Rückgängigmachen mehrerer Aktionen und kontextsensitiver Hilfe für Sprachelemente.

Während Sie die Benutzeroberfläche einer Anwendung entwerfen, erzeugt Appmethod den zugrunde liegenden Quelltext. Änderungen, die Sie an den Objekteigenschaften vornehmen, werden automatisch in die Quelltextdateien übernommen.

Da all Ihre Programme bestimmte gemeinsame Merkmale aufweisen, erstellt Appmethod dafür automatisch Quelltext und legt somit die Grundlage für Ihre Programmierung. Sie können sich den automatisch erzeugten Quelltext als eine Art Gliederung vorstellen, die Ihnen bei der Erstellung eines Programms Orientierung bietet.

Im Thema Kontextmenü des Quelltext-Editors sind die Kontextmenübefehle für den Quelltext-Editor beschrieben.

Dieser Abschnitt enthält eine Beschreibung der Leistungsmerkmale des Quelltext-Editors, die Sie bei der Programmentwicklung unterstützen.

Änderungsbalken

Auf der linken Seite des Quelltext-Editors wird vor den Zeilen, die in der aktuellen Bearbeitungssitzung nicht geändert wurden, ein grüner Änderungsbalken angezeigt. Ein gelber Änderungsbalken zeigt an, dass seit dem letzten Speichern Änderungen vorgenommen wurden.

Sie können die Standardfarben (grün und gelb) der Änderungsbalken nach Bedarf anpassen. Wählen Sie Tools > Optionen > Editor-Optionen Farbe. Wählen Sie aus dem Dropdown-Menü Element die Option Geänderte Zeile, und ändern Sie dann die Vorder- und Hintergrundfarben.

Codeeinzug

Mit der Taste TAB können Sie die aktuelle Codezeile oder einen Codeblock im Quelltext-Editor einrücken. Die Anzahl der Leerzeichen, die mit der Taste TAB einfügt werden, wird mit der Option Einrückung im Dialogfeld Tools > Optionen > Editor-Optionen > Quelloptionen festgelegt.

  • Um eine Codezeile einzuziehen, setzen Sie den Cursor an den Zeilenanfang und drücken die Taste TAB.
  • Um einen gesamten Codeblock einzuziehen, markieren Sie den Codeblock und drücken die Taste TAB.
  • Um Text nach links zu verlagern ("auszurücken"), drücken Sie UMSCHALT+TAB.

Codeformatierung

Appmethod enthält eine anpassbare Quelltextformatierung. Bei der Bearbeitung von Code im Quelltext-Editor können Sie mit dem Kontextmenübefehl Quelltext formatieren (oder dem Menübefehl Bearbeiten > Quelltext formatieren) den Quelltext formatieren. Sie können in der Gruppe Formatierung des Dialogfeldes Optionen (Tools > Optionen > Formatierung) Formatierungsoptionen für Einzug, Leerzeichen, Zeilenumbrüche, Schreibweise und Ausrichten festlegen. Mit dem Befehl Quelltext formatieren wird der Code automatisch formatiert. Dabei werden nur die Formatierungsoptionen verwendet, die Sie im Dialogfeld Optionen festgelegt haben. Alle manuellen Formatierungen, die Sie im Quelltext-Editor vorgenommen haben, werden überschrieben. Beispielsweise gehen manuelle Einzüge verloren. Wenn Sie den Befehl Quelltext formatieren für einen ausgewählten Codeblock aufrufen, wird nur dieser Codeblock formatiert.

Hinweis: Die Seiten Editor-Optionen des Dialogfeldes "Tools-Optionen" enthalten weitere Optionen zur Quelltextformatierung, u. a. Quelloptionen, Farbe, Anzeigeoptionen, Tastaturbelegung und Code Insight. Siehe Quelltext-Editor anpassen.

Code Insight

Als Code Insight wird eine bestimmte Untergruppe von Funktionen bezeichnet, die in den Quelltext-Editor eingebettet ist und dazu dient, die Eingabe von Quelltext zu erleichtern (Hinweise zu Code-Parametern und Quelltext, Symbolbeschreibung, Programmierhilfe, Klassenvervollständigung, Blockvervollständigung sowie Quelltext-Browser). Diese Funktionen unterstützen Sie beim Identifizieren häufig verwendeter Anweisungen, die Sie in den Quellcode einfügen möchten, und bei der Auswahl von Eigenschaften und Methoden. Auf einige dieser Funktionen wird in den folgenden Unterabschnitten detaillierter eingegangen.

Sie können Code Insight aufrufen, indem Sie im Quelltext-Editor die Tastenkombination STRG+LEER drücken. In einem Popup-Fenster wird dann eine Liste der Symbole angezeigt, die an der Cursorposition zulässig sind.

Um die Funktionen von Code Insight zu aktivieren oder zu konfigurieren, wählen Sie Tools > Optionen > Editor-Optionen und klicken auf Code Insight.

Bei der Programmierung in Object Pascal werden im Popup-Fenster keine Deklarationen von Interface-Methoden angezeigt, auf die in Lese- und Schreibroutinen für Eigenschaften Bezug genommen wird. Die Liste enthält nur Eigenschaften und eigenständige Methoden, die im Interface-Typ deklariert sind. Code Insight unterstützt WM_xxx-, CM_xxx- und CN_xxx-Botschaftsmethoden, basierend auf gleichnamigen Konstanten, die in den Units der uses-Klausel enthalten sind.

Code-Parameter

Diese Funktion zeigt einen Hinweis mit den Argumentnamen und -typen für Methodenaufrufe an. Sie steht zur Verfügung, wenn sich der Cursor zwischen den Klammern eines Aufrufs befindet, z. B. ShowMessage ( | );.

Drücken Sie STRG+UMSCHALT+LEER, um die Hinweise für Code-Parameter zu aktivieren.

Quelltext-Hinweise

Diese Funktion zeigt einen Hinweis mit Informationen zum aktuellen Symbol an (Typ, Datei, Zeilennummer der Deklaration).

Der Quelltext-Hinweis wird angezeigt, wenn Sie den Mauszeiger im Quelltext-Editor auf einen Bezeichner setzen.

Hinweis: Quelltext-Hinweise werden für Object Pascal nur angezeigt, wenn die Symbolbeschreibung deaktiviert ist. Um die Symbolbeschreibung zu deaktivieren, entfernen Sie das Häkchen im Dialogfeld Tools > Optionen > Editor-Optionen > Code Insight von der Option Symbolbeschreibung.

Symbolbeschreibung

Die Symbolbeschreibung zeigt einen Hinweis mit Informationen zum aktuellen Symbol an (wie Typ, Datei, Zeilennummer mit der Deklaration sowie die mit dem Symbol verknüpfte XML-Dokumentation, sofern vorhanden).

Die Symbolbeschreibung wird eingeblendet, wenn Sie den Mauszeiger im Quelltext-Editor auf einen Bezeichner setzen. Sie können die Symbolbeschreibung auch mit der Tastenkombination STRG+UMSCHALT+H aktivieren.

Programmierhilfe

Mit der Programmierhilfe können Sie eine Liste der Symbole anzeigen, die an der aktuellen Cursorposition eingefügt werden können. So aktivieren Sie die Programmierhilfe:

  • Drücken Sie STRG+LEER (ruft die Programmierhilfe immer auf).
  • Geben Sie einen Punkt . ein (ist nur möglich, wenn "Automatisch aufrufen" auf der Seite Code Insight aktiviert ist).

Um die Programmierhilfe zu beenden, drücken Sie die Taste ESC.

Klassenvervollständigung

Die Klassenvervollständigung vereinfacht das Definieren und Implementieren neuer Klassen, indem für die zu deklarierenden Klassen-Member Skeleton-Quelltext generiert wird. Wenn Sie den Cursor im interface-Abschnitt einer Unit in eine Klassendeklaration setzen und STRG+UMSCHALT+C drücken (oder mit der rechten Maustaste klicken und im Kontextmenü des Quelltext-Editors den Befehl Klasse beim Cursor vervollständigen auswählen), werden alle noch nicht abgeschlossenen Eigenschaftsdeklarationen vervollständigt. Für alle Methoden, die eine Implementierung erfordern, werden leere Methoden in den implementation-Abschnitt eingefügt.

Sie können mit dieser Funktion auch interface-Deklarationen für Methoden ausfüllen, die Sie im implementation-Abschnitt definieren.

Blockvervollständigung

Wenn Sie im Quelltext-Editor EINGABE drücken, und ein Quelltextblock vorhanden ist, der nicht korrekt geschlossen wurde, wird in der nächsten leeren Zeile nach der aktuellen Cursorposition der Bezeichner für das Schließen des Blocks eingefügt. Wenn Sie beispielsweise für ein Object Pascal-Programm im Quelltext-Editor das Token begin eingeben und anschließend EINGABE drücken, wird die Anweisung automatisch vervollständigt. Sie lautet dann: begin end.

Quelltext-Browser (STRG+KLICK)

Wenn Sie im Quelltext-Editor eine Anwendung (z. B. eine FireMonkey-Formularanwendung) bearbeiten, können Sie mit STRG+KLICK automatisch zu dem Code wechseln, in dem ein Bezeichner definiert wird. Um den Code zu durchsuchen, halten Sie die Taste STRG gedrückt und führen den Mauszeiger über den Namen einer Klasse, Variable, Eigenschaft, Methode oder eines anderen Bezeichners. Der Mauszeiger nimmt die Form einer Hand an, und der Bezeichner wird hervorgehoben und unterstrichen dargestellt. Wenn Sie auf diesen klicken, wird die Deklaration des Bezeichners im Quelltext-Editor angezeigt, wozu ggf. auch die Quelltextdatei geöffnet wird.

Sie können dies auch ausführen, indem Sie mit der rechten Maustaste auf einen Bezeichner klicken und dann im Kontextmenü Deklaration suchen wählen.

Der Quelltext-Browser kann nur Units finden und öffnen, die im Suchpfad des Projekts oder im globalen Suchpfad enthalten sind. Verzeichnisse werden in der folgenden Reihenfolge durchsucht:

  1. Entweder der projektspezifische Suchpfad für Object Pascal (Projekt > Optionen > Object Pascal-Compiler) oder der Include-Pfad für C++ (Projekt > Optionen > Verzeichnisse und Bedingungen).
  2. Der globale Suchpfad (für Object Pascal: Tools > Optionen > Umgebungsoptionen > Object Pascal-Optionen > Bibliothek oder für C++: Tools > Options > Umgebungsoptionen > C++-Optionen > Pfade und Verzeichnisse).

Eine Alternative für STRG+KLICK, um zu der Deklaration eines Bezeichners zu wechseln, ist ALT+AUF (Pfeiltaste). Weitere nützliche Tastenkombinationen finden Sie unter Standard-Tastaturvorlage.

Navigation durch den Quelltext

In den folgenden Abschnitten werden die Möglichkeiten für die Navigation im Quelltext-Editor beschrieben.

Methodennavigation

Für die Navigation von Methode zu Methode stehen verschiedene Tastaturkürzel zur Verfügung. Es ist möglich, die Navigationsfunktion auf die Methoden der aktuellen Klasse zu beschränken. Wenn die Klassensperre aktiviert ist, und sich der Cursor z. B. auf einer Methode von TComponent befindet, kann nur zwischen Methoden von TComponent navigiert werden.

Folgende Tastaturkürzel für die Methodennavigation stehen zur Verfügung:

  • STRG+Q^L – Aktivieren/Deaktivieren der Klassensperre.
  • STRG+ALT+AUF – Wechseln zum Anfang der aktuellen Methode oder zur vorherigen Methode.
  • STRG+ALT+AB – Wechseln zur nächsten Methode.
  • STRG+ALT+POS1 – Wechseln zur ersten Methode im Quelltext.
  • STRG+ALT+ENDE – Wechseln zur letzten Methode im Quelltext.
  • STRG+ALT+MAUSRAD – Blättern durch Methoden.

Suchen von Klassen

Ermöglicht das Suchen von Klassen. Wenn Sie Suchen > Klasse suchen wählen, wird eine Liste aller im Projekt verwendeten Klassen angezeigt. Nach Auswahl einer Klasse navigiert die IDE automatisch zu deren Deklaration.

Suchen von Units

Wenn Sie in Object Pascal programmieren, können Sie mit einer Refactoring-Funktion nach Namespaces oder Units suchen. Mit dem Befehl Units suchen können Units gesucht und zur Quelltextdatei hinzugefügt werden.

Suchen der nächsten und vorherigen Änderungen

Bei der Bearbeitung des Quelltextes können Sie mit den folgenden Tastenkombinationen schnell zu den nächsten und vorherigen Änderungen navigieren. Folgende Tastenkombinationen stehen zur Verfügung:

  • STRG+UMSCHALT+F7 – Wechselt in die vorherige Zeile, die seit dem Öffnen der Datei geändert wurde (grüne Markierung in der Leiste).
  • STRG+UMSCHALT+F8 – Wechselt in die nächste Zeile, die seit dem Öffnen der Datei geändert wurde (grüne Markierung in der Leiste).
  • ALT+UMSCHALT+F7 – Wechselt in die vorherige Zeile, die seit dem letzten Speichern der Datei geändert wurde (gelbe Markierung in der Leiste).
  • ALT+UMSCHALT+F8 – Wechselt in die nächste Zeile, die seit dem letzten Speichern der Datei geändert wurde (gelbe Markierung in der Leiste).

Wenn sich die nächste oder vorherige Zeile in einem ausgeblendeten (gefalteten) Block befindet, wird der Block eingeblendet. Das Code-Folding wird weiter unten in diesem Thema beschrieben.

Für die folgenden Tastaturbelegungen sind die Tastenkombinationen identisch: Standard, IDE - Klassisch, Brief und Epsilon. Die Tastaturbelegungen für Visual Studio und Visual Basic verfügen über keine Tastenkombinationen für "Nächste/Vorherige Änderung".

Durchsuchen des Quelltextes nach Verwendungen

Wenn Sie in Object Pascal programmieren, können Sie mit Verwendung suchen die Verwendung von Klassen, Methoden, Variablen und überschreibenden Methoden, abgeleiteten Klassen und implementierten Interfaces in Quellcodeprojekten suchen.

Live-Vorlagen

Live-Vorlagen ermöglichen es, eine Sammlung vorgefertigter Quelltextsegmente zu erstellen, die während der Arbeit im Quelltext-Editor in Programme eingefügt werden können. Dadurch reduziert sich Ihre Schreibarbeit.

Über die Links am Ende dieses Themas finden Sie weitere Informationen zur Erstellung und Verwendung von Live-Vorlagen.

Code-Folding

Mithilfe des Code-Folding können Sie bestimmte Bereiche oder Blöcke des Quelltextes ein- und ausblenden. Das Ausblenden von Codebereichen erzeugt eine hierarchische Darstellung des Quelltextes. Dies erleichtert das Lesen und Navigieren in großen Dateien. Der ausgeblendete Code wird nicht gelöscht, sondern nur so lange verborgen, bis Sie ihn wieder einblenden. Das Code-Folding ist standardmäßig aktiviert.

Klicken Sie zum Aus- und Einblenden von Codeblöcken im Quelltext-Editor auf die Plus- bzw. Minuszeichen links neben den jeweiligen Codeabschnitten:

  • Klicken Sie auf das Pluszeichen (+), um den zugehörigen Quelltextbereich einzublenden.
  • Klicken Sie auf das Minuszeichen (-), um den zugehörigen Quelltextbereich auszublenden.

So aktivieren/deaktivieren Sie das Code-Folding:

  • Aktivieren Sie im Dialogfeld Tools > Optionen > Editor-Optionen das Kontrollkästchen Code-Folding.
  • Drücken Sie die Tastenkombination STRG+UMSCHALT+K+O.

Sie können auch mit dem Befehl Ausblenden des Kontextmenüs bestimmte Abschnittstypen, wie Typen, Methoden, XML-Dok-Kommentare (für Object Pascal) und den "nächsten" Abschnitt ausblenden. Die Befehle Ausblenden und Einblenden sind im Thema Kontextmenü des Quelltext-Editors beschrieben. Weitere Informationen zum Code-Folding, einschließlich dem Erstellen von Bereichen für das Code-Folding, finden Sie unter Code-Folding verwenden.

Refactoring

Beim Refactoring wird Ihr Quelltext ohne Veränderung der externen Funktionalität verbessert. Sie können beispielsweise ein ausgewähltes Quelltextfragment mit dem Befehl "Methode extrahieren" in eine Methode umwandeln. Die IDE verschiebt den extrahierten Code an eine Position außerhalb der aktuellen Methode, legt die erforderlichen Parameter fest, erzeugt nach Bedarf lokale Variablen, bestimmt den Rückgabetyp und ersetzt das Codefragment durch einen Aufruf der neuen Methode. Es stehen außerdem eine Reihe anderer Refactoring-Optionen, wie z. B. das Umbenennen von Symbolen oder das Deklarieren von Variablen, zur Verfügung.

Sync-Bearbeitungsmodus

Im Sync-Bearbeitungsmodus lassen sich Bezeichner, die mehrfach im Quelltext vorhanden sind, gleichzeitig bearbeiten. Sobald Sie den ersten Bezeichner ändern, wird dieselbe Änderung automatisch für die anderen Bezeichner durchgeführt. Sie können auch Sprungpunkte setzen, um zu speziellen Abschnitten in Ihrem Quelltext zu navigieren.

To-Do-Listen

In einer To-Do-Liste werden die Aufgaben verwaltet, die in einem Projekt noch erledigt werden müssen. Nachdem Sie eine Aufgabe in die To-Do-Liste eingefügt haben, können Sie sie bearbeiten, als Kommentar in den Quelltext einfügen, als erledigt markieren oder aus der Liste entfernen. Die Liste kann auch gefiltert werden, um nur bestimmte Aufgaben anzuzeigen.

Tastatur-Makros

Während Sie Quelltext bearbeiten, können Sie eine Abfolge von Tastenanschlägen als Makro aufzeichnen. Nach der Aufzeichnung des Makros können die aufgezeichneten Tastenanschläge in der IDE während der aktuellen Arbeitssitzung beliebig oft wiederholt werden. Ein neu aufgezeichnetes Makro ersetzt das zuvor aufgezeichnete.

Positionsmarken

Positionsmarken erleichtern die Navigation in langen Dateien. Sie können an einer Stelle im Quelltext eine Positionsmarke einfügen und später von jeder beliebigen Stelle der Datei aus zu dieser Marke wechseln.

Wenn Sie eine Positionsmarke setzen, wird in der linken Leiste des Quelltext-Editors ein Positionsmarkensymbol Positionsmarkensymbol angezeigt. In einer Datei können bis zu zehn Positionsmarken (mit den Nummern 0 Bookmark0.bmp bis 9 Bookmark9.bmp) gesetzt werden.

Positionsmarken können per Drag&Drop in der Leiste des Quelltext-Editors verschoben werden. Verschobene Positionsmarken behalten die Nummer der ursprünglichen Positionsmarke bei.

Kommentarblöcke

Ein Codeblock lässt sich in einen Kommentar umwandeln, indem Sie ihn im Quelltext-Editor auswählen und dann STRG+# (Nummernzeichen) drücken. Dadurch werden jeder Codezeile des ausgewählten Blocks die Kommentarzeichen // vorangestellt, und der gesamte Block wird vom Compiler ignoriert. Die Tastenkombination STRG+# fungiert als Schalter, der Kommentarzeichen entweder hinzufügt oder entfernt. Die Wirkung hängt davon ab, ob sich vor der ersten Codezeile bereits die Zeichen // befinden. Bei Verwendung der Visual Studio- oder Visual Basic-Tastaturbelegung müssen Kommentarzeichen mit STRG+K+C hinzugefügt und entfernt werden.

Siehe auch