Die Window-Klasse erstellt Top-Level-Fenster, die mit Gruppen von Widgets gefüllt werden können. Diese Gruppen sind Elemente der Top-Level-Fenster. Als solche werden Gruppen automatisch weitergeleitet, wenn sich die Größe ihres übergeordneten Objekts ändert. So können Sie flexible GUI-Layouts erstellen, die sich automatisch an den verfügbaren Bildschirmbereich anpassen. Zusätzlich können Sie auch Menüleisten und Symbolleisten an ein Fenster zuweisen.
Fenster sind Elemente der Application-Klasse (Anwendung). Wenn Sie Fensterobjekte dynamisch erstellen, müssen Sie diese zunächst dem Applications-Objekt hinzufügen, indem Sie Application.AddWindow aufrufen.
Wenn Sie Dialoge öffnen müssen, können Sie dies tun, indem Sie Objekte der Dialog-Klasse erstellen. Dialoge sind spezielle Top-Level-Fenster, die den Rest vom Programm blockieren, bis sie geschlossen werden. Dialoge werden typischerweise verwendet, wenn Benutzeraktionen erforderlich sind, um eine Aufgabe fortzusetzen oder um anzuzeigen, dass das Programm gerade beschäftigt ist. Ein Dialog könnte dann z.B. einen Fortschrittsbalken anzeigen. Siehe Dialog-Klasse für Details.
Hier ist ein minimales Beispiel für die Erstellung eines Fensters in XML:
<window title="Hello World!">
<vgroup>
<button id="btn">Hello World!</button>
</vgroup>
</window>
|
Beachten Sie, dass das Wurzelelement eines Fensters immer ein
einzelnes Gruppenobjekt sein muss, d.h. eine Instanz von Group-Klasse
(Gruppen). Siehe Group-Klasse für Details. In unserem Beispiel verwenden wir
eine <vgroup> als Wurzelelement. Es ist nicht erlaubt,
mehrere Elemente auf der Wurzelebene des Fensters zu haben,
darum dürfen Sie nur ein einziges Gruppenobjekt als Wurzelelement
verwenden.
Fenster, die im XML-Code definiert oder von moai.CreateApp()
erstellt wurden, werden automatisch geöffnet, es sei denn, Sie
setzen explizit Window.Open auf False, damit sie geschlossen
bleiben. Fenster, die mit moai.CreateObject()
erstellt wurden, werden dagegen nicht automatisch geöffnet.
Sie müssen sie zunächst der Fensterliste des Programms hinzufügen,
indem Sie die Methode Application.AddWindow aufrufen
und dann Window.Open auf True setzen.