Files
TerminalBasic/docs/tutorial.md

66 lines
3.2 KiB
Markdown

# Tutorial: Vom Formular zum laufenden Programm
## Projekt und Formular erstellen
File → New Project erzeugt ein Projekt. File → New Form öffnet ein neues
Formular im Designer. Bereits vorhandene ungespeicherte Arbeit lässt sich
im Wechsel-Dialog speichern, verwerfen oder mit Cancel behalten.
File → Save Project speichert das Projekt und seine Mitglieder; die Pfade
und mögliche Überschreibbestätigungen stehen im Speicherdialog.
## Oberfläche gestalten
Tools → Command Button wählt das Werkzeug. Ziehe auf der Form eine Fläche
auf; alternativ platziert ein Doppelklick auf das Toolbox-Werkzeug ein Control.
Wähle das Control. Falls die Menüleiste statt der Properties Bar sichtbar ist,
wechsle mit F10 zur Properties Bar. Page Up/Down wählt die Eigenschaft Caption. F2 aktiviert
das Wertfeld, tippe `Hallo` und bestätige mit Enter. Pfeile verschieben,
Shift+Pfeile verändern die Größe. Die tatsächlichen Klassennamen und
Eigenschaften stehen in der [Forms-Referenz](forms-referenz.md).
Für ein Control-Array setze beim ersten Control Index auf `0`. Platziere
ein zweites Control derselben Klasse, setze dessen Index auf `1` und
CtlName auf den Namen des ersten Controls. Beide gehören nun zum selben
Array. Jeder Index muss eindeutig sein; Undo nimmt die Umbenennung
einschließlich gebundener Codeverweise zurück.
## Ereigniscode schreiben
F12 öffnet die Objektauswahl. Bestätige das gewählte Control mit Enter,
wähle anschließend Click und bestätige erneut. Die IDE öffnet beziehungsweise erzeugt die passende Prozedur.
Schreibe zwischen SUB und END SUB:
```basic
PRINT "Hallo aus dem Formular"
```
Mit Shift+F12 gelangst du wieder zum Formular. Syntaxfehler erscheinen
beim Verlassen der Zeile beziehungsweise unter View → Diagnostics.
Siehe [Editor und Übersetzung](ide-bedienung.md#editor-suche-und-quelltextpflege).
## Debuggen und ausführen
Setze im Ereigniscode mit F9 einen Breakpoint auf PRINT. Run → Set Start-up
File wählt das Formular als Startdatei. Shift+F5 startet das Projekt.
Betätige den Button im laufenden Formular: Die IDE hält vor PRINT und
zeigt den Quellort. F8 führt die Anweisung aus. F5 setzt das Programm fort.
F4 schaltet die Programmausgabe ins Vollbild und zurück; Ctrl+Break
unterbricht die Sitzung. Run → Restart beginnt erneut.
Window → Calls zeigt Aufrufrahmen; Debug → Add Watch beobachtet Ausdrücke.
Window → Immediate öffnet das Direktfenster für Kommandos im pausierten
Kontext. [Debugger und Direktfenster](ide-bedienung.md#debugger-und-direktfenster)
erklärt Fehlerhalte, Watchpoints und die Grenzen von Set Next Statement.
## Speichern und nächste Schritte
File → Save Project hält den Stand fest. Make EXE File erzeugt mit der
passenden Runtime-Vorlage ein natives Standalone-Programm. Make Library
erzeugt ohne native Zielwahl eine portable `.tbl` zur Wiederverwendung über
`tbc link` oder Add File in einem anderen Projekt. Beide Exporte übernehmen
auch ungespeicherte Bearbeitungen; Esc bricht die Erzeugung ab.
Siehe [Export und Voraussetzungen](ide-bedienung.md#native-exporte-ui-in-phase-5-erzeugung-in-phase-6).
Weiter: [Tastatur](tastatur.md), [Hilfe benutzen](hilfe.md),
[Sprachreferenz](sprachreferenz.md), [Bibliothek](bibliothek.md).