GUI [Graphical User Interface]

Version 1.0 by TT-Soft für QuickBasic 4.5 und Future-Library

Benutzer-Handbuch und Referenz

1. Einleitung

Dieser GUI wurde von TT-Soft (Member of East-Power-Soft) im September/Oktober 2001 entwickelt. Letzte Update's und mehr findest Du unter: http://www.East-Power-Soft.de
Das Basic-Programm und alle seine Teile (SUB’s) sind grundsätzlich als Freeware zu verstehen und dürfen angepasst bzw. editiert werden. Eine Weitergabe der Software ist nicht verboten, sondern sogar erwünscht.

Ausnahmen:
Dieser GUI nutzt die Future-Library V3.50 von Future-Software, created by Michael Rye Sørensen and Jorden Chamid (c)1999-2000 by Future Software. Diese Library wird nicht mitgeliefert. Sie ist unter www.qb45.com im Original oder auf unserer Homepage www.East-Power-Soft.de mit deutscher Übersetzung erhältlich. Diese Library ist Freeware und darf weitergegeben werden. Jedoch, ohne die Zustimmung von Future-Software, weder editiert noch anderweitig geändert werden.
Die im GUI verwendete Palette wurde mit Paint-Shop-Pro erzeugt. Paint-Shop-Pro ist ein eingetragenes Warenzeichen der Firma JASC-Inc.

Hinweis:
East-Power-Soft, TT-Soft, Future-Software und JASC-Inc. distanzieren sich von Problemen bzw. Hard- oder auch Softwarebeschädigungen, die durch den Einsatz der Library, einzelner Komponenten bzw. des GUI’s entstehen. Sollten Fehler im Originalprogramm festgestellt werden, so bitten ich um eine Benachrichtigung und kurze Beschreibung des Fehlers (E-Mail: TT-Soft@East-Power-Soft.de).

2. Lieferumfang
Im Paket enthalten sind folgende Dateien:

Die EPS-GUI.BAS stellt den eigentlichen GUI dar. Die Datei EXAMPLE.BAS ist ein Beispiel wie man die Fähigkeiten des GUI nutzen kann. Als Beispiel wurde eine CommonDialogBox gewählt, da dies in meinen Augen erstens ein gutes Beispiel abgibt und zweitens häufig benötigt wird.

3. Fangen wir an
Als erstes benötigen wir die Future-Library. Mit dem dazugehörigen Builder binden wir die Module für SVGA, SVGA-Maus-Unterstützung, Font-Laden sowie Bildimport/export ein.

Die EpsInitialize Routine muß vor allen anderen aufgerufen werden. Hier finden alle notwendigen Prüfungen statt, wie z.B. Auflösung, Speicher, Font usw.
Die Variablen, die alle diese Werte angeben befinden sich in der INCLUDE-Datei und können dort editiert werden. Eine Übersicht über die nötigsten Variablen ist weiter unten.

EpsDefineElements muß nach der EpsInitialize Routine aufgerufen werden. In ihr befinden sich alle Definitionen bzw. Eigenschaften zu den einzelnen Elementen. Also z.B. wo sich welches Fenster, Button etc. befindet.

Alle SUBs die mit EpsDraw beginnen (z.B. EpsDrawButton) zeichnen das jeweilige Element, gekennzeichnet durch seine Nummer. Ausnahme ist die Routine EpsDrawScreen. Sie zeichnet den gesamten Bildschirm und alle auf ihm sichtbaren Fenster, Elemente usw. Diese Routinen prüfen jedoch nicht, ob das jetzt darzustellende Element auch gerade im aktiven, bzw. in einem sichtbaren Fenster liegt. Ausnahme ist auch hier natürlich die EpsDrawScreen Routine.

Folgende Elemente stehen zur Verfügung:

- AWindow (Fenster)
- Button (Schaltknöpfe)
- Frame (Rahmen)
- Picture (Bilder [256 Farben BMP])
- TextField (Texteingabefelder)
- Label (Textanzeigefelder)
- CheckBox (Optionsfelder)
- RadioButton (Auswahlfelder)
- Scrollbar (Schieberegler)
- Percentbar (Fortschrittleisten)
- TextBox (Listenauswahlbox)

Die EpsMainLoop ist, wie ihr Name schon sagt, die eigentliche Engine die alle Elemente steuert und deren Funktionsweise koordiniert.

4. Die Variablen
Hier nun eine Übersicht der wichtigsten Variablen die voreingestellt werden sollten (müssen). Sie befinden sich in der INCLUDE-Datei (EPS-GUI.BI).

5. Die Handhabung
Ich habe im GUI bewusst auf diverse Prüfungen verzichtet, wie z.B. ob ein Button auch tatsächlich in ein Fenster passt, usw. Dies verbraucht nicht nur einen haufen Speicherplatz, sondern ist auch unnötig, da man ja ohnehin prüft ob es passt oder nicht. Generell ist der GUI sehr „sporadisch“. Schließlich soll er lediglich die Möglichkeit bieten, seinem Programm die nötige grafische Oberfläche zur Verfügung zu stellen. So ging es mir bei der Entwicklung hauptsächlich darum, daß er sehr Leistungsfähig aber trotzdem klein und leicht verständlich bzw. handhabbar ist.

Beginnen wir mit einem kleinen Beispiel. Wir erstellen uns eine Message-Box. Die Definitionen für ein Fenster und einen „OK“ - Button schreiben wir in die SUB EpsDefineElements. Und so könnte das z.B. aussehen:

SUB EpsDefineElements

   AWindow(1).Caption = “Message-Box“
   AWindow(1).BackColor = Grey
   AWindow(1).High = 150
   AWindow(1).Widh = 250
   AWindow(1).PosX = 100
   AWindow(1).PosY = 100
   AWindow(1).State = True
   AWindow(1).Visible = True

   Button(1).Caption = „OK“
   Button(1).High = 20
   Button(1).Widh = 40
   Button(1).PosX = 105
   Button(1).PosY = 70
   Button(1).Alignment = Center
   Button(1).State = True
   Button(1).InWindow = 1

END SUB

Nun gut, nachdem wir die Elemente für Fenster und Button definiert haben, rufen wir als nächstes die EpsDrawScreen Routine auf. Sie zeichnet alle Elemente auf den Bildschirm, zumindestens die die gerade sichtbar sind. An diesem Punkt wird klar wie wir ein neues Fenster aufrufen, oder schließen können. Es muß nur die Variable AWindow(n).Visible umgestellt werden und die EpsDrawScreen Routine aufgerufen werden. sofort erscheint, bzw. verschwindet das jeweilige Fenster und mit ihm alle Elemente die sich darin befinden. Doch im Moment ist unsere MessageBox sichtbar und wir wollen den „OK“-Button abfragen. Wie machen wir das? Prinzipiell kann man sagen, das wir eine einzige große Schleife benötigen. In ihr fragen wir kontinuierlich ab, ob einer der Button oder eines der anderen Elemente gedrückt wurde und reagieren dann entsprechend. Ob, wo oder wann das Element betätigt wurde, bzw. ob es überhaupt möglich ist dieses Element zu betätigen prüft die Engine. Wir schreiben als Code nur die Reaktion darauf. Als Beispiel wollen wir die MessageBox wieder schließen wenn der „OK“-Button gedrückt wurde. Alles zusammen sieht dann, inklusive Abfrageschleife, so aus:

REM $INCLUDE:‘FUTURE.BI‘
REM $INCLUDE:‘EPS-GUI.BI‘

EpsInitialise
EpsDefineElements
EpsDrawScreen

DO: EpsMainLoop
   IF PressedButton = 1 THEN
      AWindow(2).Visible = False
      EpsDrawScreen
   END IF
LOOP UNTIL INKEY$ = MainKey$

ReSetScreen
END

Das ist alles. Eigentlich total easy – oder? Abgefragt wird von der Engine übrigens jeder Maus-Klick der in irgend ein Element ging, außer dem Frame und dem Label. Also auch Bilder können abgefragt werden. Die Abfrage- und Einstellungs-Variablen siehst du in nachfolgender Übersicht. Insgesamt sind alle Variablen zugänglich und zu jeder Zeit veränderbar. Interessant sind vielleicht noch die verwendeten Variablen für die Maus:

MX = aktuelle Mausposition X
MY = aktuelle Mausposition Y
MB = Status der Mausknöpfe (0 = keiner gedrückt, 1 = linker, 2 = rechter Mausknopf)

6. Die Elemente, Routinen und Elementeigenschaften:

SUB EpsDrawWindow (Nummer des Fensters von 1 bis MaxAWindow)

SUB EpsDrawButton (Nummer des Buttons von 1 bis MaxButton)

SUB EpsDrawFrame (Nummer des Rahmens von 1 bis MaxFrame)

SUB CheckBox (Nummer der CheckBox von 1 bis MaxCheckBox)

SUB EpsDrawScrollBar (Nummer der ScrollBar von 1 bis MaxScrollBar)

SUB EpsDrawPercentBar (Nummer der Prozentleiste von 1 bis MaxPercentBar)

SUB EpsDrawLabel (Nummer des Labels von 1 bis MaxLabels)

SUB EpsDrawPicture (Nummer des Bildes von 1 bis MaxPicture)

SUB EpsDrawTextField (Nummer des Textfeldes von 1 bis MaxTextField)

SUB EpsDrawTextBox (Nummer der TextBox von 1 bis MaxTextBox)

7. Nachtrag und Tipps
Natürlich können alle Routinen die nicht benötigt werden einfach gelöscht werden. Also wenn man z.B. keine Frame’s benutzt, kann die SUB EpsDrawFrames ohne weiteres gelöscht werden. Um Speicherplatz zu sparen, ist es auch sinnvoll die SUB-Routinen (EPS-GUI.BAS) in eine Quick-Bibliothek umzuwandeln und direkt in QuickBasic einzubinden. Weiterhin kann man sich vielleicht eine Lade-Routine schreiben, die alle Daten für die Fenster, Buttons usw. lädt. Ohne dies ist es nämlich ne ganze Menge Schreibarbeit. Ich habe allerdings keine eigene Routine dafür geschrieben, da sich so besser erklären läßt wozu der GUI fähig ist.

Natürlich setze ich den GUI selbst auch ein, wofür habe ich ihn sonst entwickelt ;-). Ausserdem habe ich vor, einen Formeneditor zu schreiben, mit dessen Hilfe man leichter Fenster erstellen und Elemente darin positionieren kann. Spätestens dann kommt allerdings eine Laderoutine. Also immer mal auf unserer Seite vorbeischauen ob sich was getan hat. Solltest Du Lust bekommen haben diesen GUI einzusetzen, dann wäre es nett wenn Du mir Dein fertiges Produkt, oder zumindest einen Screenshot davon, mal zeigen könntest.

Viel Spaß und gutes Gelingen wünscht TT-Soft.