TerminalBasic/openspec/changes/phase-4-steuerelemente/proposal.md

Phase 4 (Abschluss) — Steuerelemente, Menüs, Dialoge

Why

Das Objektmodell (phase-4-objektmodell) macht Formulare und Steuerelemente ansprechbar, zeigt aber nichts an und nimmt nichts entgegen. Dieser Change füllt die Klassen mit Verhalten: Darstellung im Zellenpuffer, Fokus- und Tabreihenfolge, Access-Keys, Maussteuerung, Menüsystem und die drei vordefinierten Dialoge. Damit schließt Phase 4.

Die drei Dialoge (MSGBOX als Anweisung und als Funktion, INPUTBOX$) sind die letzten drei offenen Inventareinträge der Phase. Sie stehen in keiner Steuerelementliste und fielen deshalb bisher zwischen die Aufgaben.

What Changes

• Steuerelementklassen mit Verhalten: CommandButton, TextBox, ListBox, ComboBox, CheckBox, OptionButton, Frame, Label, HScrollBar, VScrollBar, PictureBox, Timer sowie die Dateisystem-Steuerelemente DirListBox, DriveListBox und FileListBox — je mit Darstellung, Zuständen (normal, fokussiert, deaktiviert) und ihren Methoden.
• Darstellung im Zellenpuffer: Steuerelemente zeichnen in den vorhandenen Textbildschirm; es entsteht keine zweite Zeichenschicht. Die höhenabhängige Darstellung des CommandButton (1 Zeile <Text>, 2 Zeilen Rahmen, ab 3 Zeilen Kasten) und die Rahmenarten der übrigen Klassen folgen der Forms-Referenz.
• Fokus, Tabreihenfolge, Access-Keys: TabIndex/TabStop, Weiterschalten mit Tab und Umschalt-Tab, & im Text als Access-Key, Default- und Cancel-Schaltfläche für Enter und Esc, SETFOCUS, GotFocus/LostFocus.
• Maussteuerung: Die Mausereignisse aus phase-4-ereignisschleife werden auf Steuerelemente abgebildet — Trefferprüfung über die Z-Reihenfolge, Klick, Doppelklick, MouseDown/MouseMove/MouseUp sowie Ziehen und Ablegen (DragMode, DRAG, DragDrop, DragOver).
• Menüsystem: Menüleiste je Formular, bis zu sechs Ebenen, Access-Keys, Shortcuts, Checked/Enabled/Visible/Separator, Menü-Steuerelement-Arrays. Während ein Menü den Fokus hält, ruhen Zeitereignisse und Traps.
• Vordefinierte Dialoge (3 Inventareinträge): MSGBOX als Anweisung und als Funktion mit den Schaltflächengruppen und Rückgabewerten der Sprachreferenz, INPUTBOX$ mit fester Größe 46×16 Zeichen und Positionierung in Zeichen.
• Timer als Steuerelement: Interval 0–65 535 ms auf der Zeitquelle der Ereignisschleife, Ereignis Timer.

Non-Goals: Der Formular-Designer und die Projektverwaltung (Phase 5); native Erweiterungssteuerelemente (Stufe 2); grafische Ausgabe in der PictureBox — sie ist eine Textzeichenfläche.

Capabilities

New Capabilities

• forms-steuerelemente: Verhalten und Darstellung der Steuerelementklassen, Fokus- und Tabreihenfolge, Access-Keys, Maussteuerung mit Ziehen und Ablegen, Menüsystem und die vordefinierten Dialoge.

Modified Capabilities

• kompat-testkorpus: Der Korpus SHALL Formularprogramme mit Bildschirm-Sollausgabe und deterministischer Ereignisfolge führen.

Impact

• crates/tb-ui: Darstellung und Eingabebehandlung je Klasse, Menüs, Dialoge, Trefferprüfung, Fokusverwaltung.
• crates/tb-runtime: Fehler 260–480 des Forms-Bereichs als Auslöser; MSGBOX/INPUTBOX$ als Sprachelemente.
• crates/tb-frontend: Signaturen von MSGBOX (Anweisung und Funktion) und INPUTBOX$; die Unsupported-Absenkung von MSGBOX entfällt.
• tests/compat: Formularprogramme mit Sollausgabe; die Programme aus github.com/cout/vbdos als Kompatibilitätsnachweis.
• docs/: forms-referenz.md — die offenen Detailfragen (Optik je Zustand, Z-Reihenfolge, Reihenfolge gleichzeitig fälliger Timer) werden beantwortet; inventar.md setzt die Einträge dieses Changes auf implementiert.
• PLAN.md: Punkte „Steuerelemente", „Menüsystem", „Fokus-/Tab-Reihenfolge", „Vordefinierte Dialoge" und die beiden Meilensteine der Phase 4.