Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v19
Methode schreiben
|
Ausgewählten Text in eine Zwischenablage kopieren | Inhalt der Zwischenablage an Cursor-Position setzen | |
Windows | Shift oder Alt+Klick auf Icon der Zwischenablage | Strg+Klick auf Icon der Zwischenablage |
Shift oder Alt+Nummer der Zwischenablage | Strg+Nummer der Zwischenablage | |
MacOS | Shift oder Wahltaste+Klick auf Icon der Zwischenablage | Befehl+Klick auf Icon der Zwischenablage |
Befehl+Shift-taste+Nummer der Zwischenablage | Befehl+Nummer der Zwischenablage |
Sie können die Zeile, wo der Cursor steht, direkt ohne Auswählen bewegen. Wählen Sie dazu im Menü Methode den Befehl Zeilen nach oben verschieben bzw. Zeilen nach unten verschieben. Sie können auch die Kombination Alt-Taste/Wahltaste + Pfeil oben oder Pfeil unten verwenden.
Farbige Balken erscheinen sofort, wenn Code-Zeilen nach dem Öffnen der Methode verändert wurden:
Die Farbe richtet sich danach, ob die Änderungen gesichert sind oder nicht:
Der Methodeneditor bietet “autocomplete” Funktionen. Damit zeigt 4D anhand der ersten eingegebenen Zeichen automatisch Vorschläge an.
Im nachfolgenden Beispiel löst die Eingabe der Zeichenfolge “cop” die Anzeige eines blauen Dreiecks aus und zeigt somit an, dass es mehrere Auswahlmöglichkeiten gibt:
Entspricht die eingegebene Zeichenfolge einer einzigen Möglichkeit, erscheint der vorgeschlagene Wert in Grauschrift. Der komplette Eintrag wird eingefügt, wenn Sie die Tabulatortaste drücken:
--->
Hinweis: Haben Sie auf der Seite Methoden in den 4D Einstellungen die Option Einfügen von () und Schließen von } ) ] " markiert, fügt 4D auch automatisch entsprechende Klammern nach einem 4D Befehl, Schlüsselwort oder einer Projektmethode hinzu, die eine oder mehrere zwingende Argumente erfordert, sobald ein Vorschlag gewählt wurde: ->
"Autocomplete" funktioniert auch mit Code Strukturen (z.B. If..End if, For each...End for each): Geben Sie den ersten Teil der Anweisung ein, schlägt der Methodeneditor automatisch den schließenden Teil vor:
Gibt es mehrere Vorschläge, zeigt 4D sie in einer PopUp-Liste an, wenn Sie die Tabulatortaste drücken:
Die Liste erscheint in alphabetischer Reihenfolge. Doppelklicken Sie auf einen Eintrag, um ihn auszuwählen oder scrollen Sie über die Pfeiltasten an die gewünschte Stelle und drücken die Enter-Taste, Zeilenschaltung oder Tabulatortaste, um den gewählten Wert einzufügen.
Sie können standardmäßig einen vorgeschlagenen Wert, nachdem er ausgewählt wurde, auch über einen der folgenden Begrenzer ( ; : = < [ { einfügen. Der Wert wird dann zusammen mit dem Begrenzer eingefügt und ist zur Dateneingabe bereit:
+ ( Taste -->
Hinweis: Sie können die Verwendung von Begrenzern zum Eingeben vorgeschlagener Werte in den 4D Einstellungen auf der Seite Methoden deaktivieren.
Sie können auch die Esc-Taste drücken, um die PopUp-Liste zu schließen oder weitere Zeichen einzutippen. Die vorgeschlagenen Werte in der Liste aktualisieren sich, wenn neue Zeichen dazu kommen.
Treffen die eingegebenen Zeichen für verschiedene Objekttypen zu, erscheinen sie in der Liste im entsprechenden Stil. Es lassen sich folgende Objekttypen anzeigen:
Hinweis: Aus praktischen Gründen können Sie die automatische Anzeige der Liste mit Vorschlägen für Konstanten, lokale und Interprozessvariablen, Objektattribute und/oder Tabellen deaktivieren. Diese Optionen finden Sie in den Benutzereinstellungen auf der Seite Methoden.
Ist die Objektnotation aktiviert, zeigt 4D - unter Berücksichtigung von Groß- und Kleinschreibung - automatisch Vorschläge aller gültigen Namen für Obektattribute in 4D Methoden, wenn Sie:
Hinweis: Das Attribut length erscheint immer (zum Verwenden mit Collections)
Beachten Sie, dass Namen von Objektattributen die ECMA Schreibregeln berücksichtigen müssen. Weitere Informationen dazu finden Sie unter Identifier für Objekteigenschaft.
Angelegte Attributnamen werden in einer internen globalen Liste gespeichert und sind immer verfügbar, wenn eine Methode geöffnet, geschlossen bzw. der Fokus geändert wird.
Die Liste mit Vorschlägen wird dynamisch aktualisiert, wenn eine Methode bearbeitet wird. Beim Wechseln zwischen Fenstern werden neue/geänderte Attribute immer zur globalen Liste hinzugefügt. Die Liste wird auch aktualisiert, wenn Sie die Methode als Vorschau im Explorer öffnen.
Beim Neustart der Anwendung wird die Liste zurückgesetzt.
Hinweis: Auf der Seite Methoden der 4D Einstellungen können Sie das automatische Anzeigen von Attributnamen aktivieren/deaktivieren.
Mit der Funktion Äußeren Block auswählen wählen Sie den “eingeschlossenen Block” im Code, der den Einfügepunkt enthält. Der Block kann definiert werden durch:
Wurde bereits ein Textblock ausgewählt, wählt die Funktion den auf der nächsthöheren Ebene gelegenen Block usw., bis die gesamte Methode ausgewählt ist.
Wollen Sie die Operation wieder rückgängig machen, wählen Sie unter Windows die Kombination Strg- + Umschalttaste+B, auf Mac OS Befehls- + Umschalttaste+B und heben die letzte Auswahl auf.
Hinweis: Liegt der Einfügepunkt in einer Struktur vom Typ If oder Else, enthält der eingeschlossene Block jeweils die If- oder Else-Anweisung.
Mit Doppelklick lassen sich "Wörter" auswählen. Enthält der Name eines Elements Leerzeichen, z.B. Befehl, Konstante, Methode, können Sie ihn mit der Kombination Alt/Wahltaste + Doppelklick vollständig auswählen.
Der Methodeneditor von 4D bietet nützliche Tastaturkürzel, um im Code zu navigieren.
Tastaturkürzel | Aktion |
[Shift]+[Pfeil nach rechts] | Auswahl erstellen und Zeichen um Zeichen nach rechts vergrößern, oder Zeichen um Zeichen nach links verkleinern |
[Shift]+[Pfeil nach links] | Auswahl Zeichen um Zeichen von rechts aus verkleinern oder Auswahl erstellen und Zeichen um Zeichen nach links vergrößern |
[Shift]+[Pfeil nach unten] | Auswahl erstellen und Zeile um Zeile von oben nach unten vergrößern |
[Shift]+[Pfeil nach oben] | Auswahl erstellen und Zeile um Zeile von unten nach oben vergrößern |
[Strg]+[Shift]+[Pfeil nach rechts] | Auswahl erstellen und Wort um Wort von rechts aus vergrößern |
[Strg]+[Shift]+[Pfeil nach links] | Auswahl Wort um Wort von rechts aus verkleinern oder Auswahl erstellen und Wort um Wort von links aus vergrößern |
[Strg]+[Pfeil nach rechts] | Einfügepunkt Wort um Wort von links nach rechts bewegen |
[Strg]+[Pfeil nach links] | Einfügepunkt Wort um Wort von rechts nach links bewegen |
[Pos1] | Einfügepunkt an Zeilenbeginn setzen (gilt nur unter Windows) |
[Ende] | Einfügepunkt an Zeilenende setzen (gilt nur unter Windows) |
[Strg]+[Pos1] | Einfügepunkt an Methodenbeginn setzen |
[Strg]+[Ende] | Einfügepunkt an Methodenende setzen |
[Shift]+[Pos1] | Alle Zeichen der Zeile wählen, die links vom Cursor stehen |
[Shift]+[Ende] | Alle Zeichen der Zeile wählen, die rechts vom Cursor stehen |
[Bild Pfeil nach oben] | Inhalt der Methode Seite für Seite von unten nach oben scrollen (verändert nicht den Einfügepunkt) |
[Bild Pfeil nach unten] | Inhalt der Methode Seite für Seite von oben nach unten scrollen (verändert nicht den Einfügepunkt) |
4D überprüft automatisch die Methodensyntax, um zu sehen, ob sie korrekt ist. Geben Sie Text ein oder wählen einen Ausdruck, der syntaktisch nicht korrekt ist, zeigt 4D das Symbol , um den fehlerhaften Ausdruck zu markieren. Bewegen Sie die Maus über das Symbol, erscheint ein Hilfetipp mit der Beschreibung des Fehlers:
Sie können die Syntax der aktuellen Zeile sehr schnell überprüfen, ohne Übergang zur nächsten Zeile, indem Sie die Eingabetaste des Nummernblocks drücken. 4D untersucht die Zeile, formatiert diese, markiert mögliche Fehler und setzt den Einfügepunkt an das Ende der Zeile. Wird eine Zeile der Methode mit inkorrekter Syntax hervorgehoben, können Sie prüfen und die Eingabe korrigieren. Ist die Zeile jetzt korrekt, entfernt 4D das Fehlersymbol. Sichern oder schließen Sie das Fenster, wird die gesamte Methode bestätigt. Sie können die Methode auch mit der Eingabetaste bestätigen.
Beim Bestätigen überprüft 4D jede Zeile auf Syntaxfehler und die Struktur der Anweisungen (If... End if, etc.). 4D prüft auch umschließende Zeichen im Code, wie Klammern oder Anführungszeichen. Haben Sie das öffnende Zeichen getippt, zeigt 4D das dazugehörige schließende Zeichen durch graue Umrahmung des startenden/endenden Zeichens an.
Hinweis: Klicken Sie im Code auf ein startendes Zeichen, zeigt 4D das dazugehörige schließende Zeichen standardmäßig mit grauen Vierecken. Sie können diese Anzeige in den 4D Einstellungen auf der Seite Methoden mit der Option "Passende Klammern" verändern oder deaktivieren.
Der Methodeneditor überprüft nur offensichtliche Syntaxfehler, wie z.B. falsche Schreibweise. Er überprüft nicht auf Fehler, die nur bei der Ausführung auftreten. Fehler in der Ausführung erfasst 4D, sobald die Methode abläuft. 4D enthält einen Debugger zum Beheben solcher Fehler. Weitere Informationen dazu finden Sie im Handbuch 4D Programmiersprache im Kapitel Debugging. Auch der Compiler ist eine unumgängliche Hilfe zur Fehlersuche. Weitere Informationen dazu finden Sie im Kapitel Kompilieren.
Der Methodeneditor bietet über Hilfetipps verschiedene Informationen im Kontext. Sie erscheinen, wenn Sie die Maus über ein Objekt bewegen.
Sie können jederzeit die HTML Dokumentation eines 4D Programmiersprache Befehls anzeigen: Dazu wählen Sie den kompletten Befehlsnamen aus und setzen einfach den Cursor in den Namen und drücken die Taste F1. Die vollständige Beschreibung des Befehls erscheint in einem neuen Fenster Ihres Standard Browser.
4D sucht nach der online Dokumentation des Befehls (auf der Website 4D Doc Center) oder lokal. Das hängt von den Einstellungen der Anwendung ab (siehe Speicherort der Dokumentation).
Kommentare sind inaktive Zeilen von Code. Diese Zeilen werden nicht vom Programm interpretiert und nicht ausgeführt, wenn die Methode aufgerufen wird. 4D verwendet in den Kommentaren keinen bestimmten Stil. Es gibt zwei Varianten:
Syntax | Beschreibung | Beispiel |
// Kommentar | Zum Erstellen einer einzelnen Kommentarzeile. Für eine einzelne Kommentarzeile setzen Sie // an den Zeilenanfang. Sie kann maximal 32.000 Zeichen lang sein. | //Dies ist ein Kommentar |
/* Kommentar */ | Zum Umklammern von Inhalt bei eingebundenen Kommentaren oder mehrzeiligen Kommentarblöcken. Beide Arten beginnen mit /* und enden mit */.
| Eingebunden:
Mehrzeilig: |
Sie rufen den Befehl Kommentar An/Aus im Menü Methode oder im Kontextmenü des Methodeneditors auf. Damit markieren Sie eine Gruppe Code-Zeilen als einzeiligen Kommentar oder entfernen umgekehrt das Zeichen für einzeiligen Kommentar aus der Auswahl.
Zuerst wählen Sie den betreffenden Ausschnitt im Code, dann den Befehl Kommentar An/Aus:
-->
Enthält die Auswahl nur aktiven Code, wird der Befehl Kommentar an angewandt.
Enthält die Auswahl aktiven Code und Zeilen mit Kommentar, wird letzteren ein weiteres Paar Kommentarzeichen (//) hinzugefügt; auf diese Weise bleibt die kommentierte Zeile erhalten, wenn später der Befehl Kommentar Aus verwendet wird.
Enthält die Auswahl nur kommentierte Zeilen, wird der Befehl Kommentar Aus angewandt.
Hinweis: Der Befehl Kommentar An/Aus arbeitet nur mit kompletten Zeilen – er kann nicht für einen Teil der Zeile verwendet werden.
Der Methodeneditor lässt Escape Sequenzen (Steuerzeichen) zu. Das ist eine Zeichenfolge, die spezielle Zeichen ersetzt.
Die Sequenz enthält einen linksgerichteten Schrägstrich (\) und ein Zeichen. \t ersetzt z.B. die Eingabe Character(Tab) für den Tabulator. Escape Sequenzen erleichtern die Eingabe von Sonderelementen.
4D arbeitet mit folgenden Sequenzen:
Escape Sequenz | Ersetzte Zeichen |
\n | LF (Zeilenvorschub) |
\t | HT (Tabulator) |
\r | CR (Zeilenschaltung) |
\\ | \ (linksgerichteter Schrägstrich) |
\" | " (Anführungszeichen) |
Hinweis: In Escape Sequenzen spielen Klein- oder Großbuchstaben keine Rolle.
Im folgenden Beispiel wird in eine Anweisung die Zeilenschaltung (Escape Sequenz\r) eingefügt, um das darunterliegende Dialogfenster anzuzeigen:
ALERT("The operation has been completed successfully.\rYou may now disconnect.")
Warnung: Der linksgerichtete Schrägstrich (\) dient unter Windows in Zugriffspfaden als Separator. 4D interpretiert im Methodeneditor eingetragene Zugriffspfade unter Windows in der Regel korrekt, weil es den einfachen Schrägstrich (\) durch doppelte Schrägstriche (\\) ersetzt. Aus C:\Ordner wird also C:\\Ordner.Schreiben Sie dagegen “C:\MeineDokumente\Neu”, zeigt 4D “C:\\MeineDokumente\Neu” an. In diesem Fall wird der zweite linksgerichtete Schrägstrich \ fälschlicherweise als die Escape Sequenz \N interpretiert. Aus diesem Grund müssen Sie bei Zeichen, die 4D als Escape Sequenz erkennt, stets zwei linksgerichtete Schrägstriche (\\) eingeben.
Verschiedene Funktionalitäten im Methodeneditor erleichtern das Lesen von Code und vereinfachen das Durchlaufen der Anweisungen.
4D Code innerhalb von Schleifen und Bedingungen lässt sich ein- oder ausblenden. Das macht die Methode übersichtlich und leichter lesbar:
Setzen Sie die Maus auf den Icon zum Aufklappen, erscheint ein Hilfetipp, der die ersten Zeilen des ausgeblendeten Code anzeigt.
Sie können den ausgeblendeten Teil des Code auswählen, kopieren, an anderer Stelle einsetzen oder löschen. Das gilt für alle darin enthaltenen Zeilen. Ausgeblendeter Code wird beim Einsetzen an anderer Stelle automatisch eingeblendet.
Es gibt verschiedene Wege, um Code ein- und auszublenden:
Zwei Befehle erleichtern das Navigieren in Code-Strukturen (If...Else...End if, etc.):
Diese Befehle sind im Menü Methode oder im Kontextmenü des Editors verfügbar. Sie können auch folgende Tastaturkürzel verwenden:
In 4D können Sie bestimmten Zeilen in Ihren Methoden Sprungmarken zuweisen. Sie können dann rasch den Code durchlaufen, indem Sie über spezielle Befehle von einer Sprungmarke zur nächsten gehen:
Sprungmarken wandern mit der Zeile mit, wenn zusätzliche Zeilen in die Methode eingefügt werden. Sie werden mit den Methoden gesichert.
Sprungmarken werden über das Menü Methode > Bookmarks verwaltet:
Hinweis: Sie können Sprungmarken als Marker für Zeilen verwenden, die einen Eintrag enthalten, der über eine Suche gefunden wurde. In diesem Fall fügt 4D automatisch die Sprungmarken hinzu. Weitere Informationen dazu finden Sie im Abschnitt Suchen und Ersetzen in Methoden.
In 4D Versionen vor v15 verwendeten die französischen Versionen die Programmiersprache in Französisch, alle anderen Versionen (Englisch, Deutsch, Spanisch, etc.) verwendeten die Programmiersprache in Englisch.
So hieß z.B. der Befehl Nr. 53 in Französisch STOCKER ENREGISTREMENT und in allen anderen Sprachen SAVE RECORD. Auch bei der Eingabe von Datum oder Werten vom Typ Zahl wurden lokale Einstellungen verwendet.
Das hat sich ab 4D v15 geändert: Der Methodeneditor von 4D verwendet den internationalen Modus, unabhängig von der Sprache der 4D Anwendung oder den lokalen Einstellungen. So lautet der Befehl No. 53 jetzt auch in der französischen 4D Version SAVE RECORD. Listen, Fenster mit type-ahead, online Hilfe, etc., zeigen die Namen von Befehlen und Konstanten in Englisch an. Weitere Informationen dazu finden Sie im Abschnitt OLD RELATED MANY.
Bei Bedarf lässt sich der vorherige Modus einstellen und zwar über die Option "Verwende regionale Einstellungen" auf der Seite Methoden im Dialogfenster 4D Einstellungen. Die oben beschriebene Vorgehensweise zum Schreiben von Code bleibt natürlich gleich, egal welche Einstellung verwendet wird.
Produkt: 4D
Thema: Methoden bearbeiten
Geändert: 4D v17 R2
IME
4D Designmodus ( 4D v19)