Beschreibung:
Dieses Tutorial soll den Einstieg in diese Programmierumgebung anhand eines Beispiels erleichtern, sowie auch allgemeine Hinweise geben, Visual-Coffee effizient zu nutzen.

Das Beispielprogramm (Projektname: sample.vcp) soll nach untenstehenden Schritten die Funktion einer Taschenrechnertastatur haben und folgendermaßen aussehen und funktionieren:

 

Schritt 1:

Nach dem Starten von Visual-Coffee sollte als erstes das leere Projekt mit einem
neuen Namen (sample.vcp) abgespeichert werden (Menüpunkt Project-Save as).

Nachdem die Grideinstellungen im Menüpunkt Options-Grid getätigt wurden, kann das erste Kontrollelement (Widget) im DrawArea erzeugt werden. Dazu wählt man mit einem einfachen Mausklick das gewünschte Element (textlabel) aus der Elementleiste aus und plaziert es mit einem Klick im DrawArea an der entsprechenden Stelle. Wir verwenden dieses textlabel als Überschrift und formatieren es gemäß der Abbildung auf Seite 5. Danach müssen im Attribute-Window noch die Schriftgröße (28) bzw. der Überschriftstext („Visual-Coffee-Beispielapplet") geändert werden.

Als nächstes wird ein Text-Feld hinzugefügt, das die Ausgabezeile unseres Applets bildet. Im Attribute-Window geben wir dem Text-Feld den Namen „display", um später im Quellcode darauf zugreifen zu können.

Um das Tastenfeld erzeugen, setzen wir zunächst einen Standard-Button in das Draw-Area und formatieren ihn auf die Größe 50 mal 50 Pixel. Durch das Drücken auf „Add To Predefined List" wird dieser Button in die Auswahlleiste aufgenommen.

Jetzt erzeugen wir mit Hilfe des soeben erstellten vordefinierten Buttons weitere 10 dieser Art. Nachdem wir diese taschenrechner-like angeordnet haben, müssen die Captures einer Taschenrechnertastatur entsprechend (siehe Screenshot auf Seite 5) verändert werden.

Nach den ersten 5 Schritten ist die Layoutphase abgeschlossen. Die folgenden Schritte behandeln die Funktion des Applets.

Im Actions-Window wird jetzt für jeden Button der Name der aufzurufenden Funktion eingetragen (Button mit Capture '0' wird Funkton b0 zugeteilt usw.; dem Button 'C' wird die Funktion 'clear' zugeteilt).

Bearbeiten des Quelltextes:

Mit Doppelklick auf eine sich im Draw-Area befindenden Komponente wird der Editor mit der Quelltextdatei aufgerufen, in der sich nur leeren Funktionsgerüste befinden. Um den Quelltext zu vereinfachen, fügen wir eine Funktion namens addNumber ein, die eine Ziffer im Text-Feld hinzufügt:

public void addNumber(int i)
{
   display.setText(display.getText() + i);
}

In die Funktionen b0 bis b9 fügt man jeweils einen Aufruf der Funktion addNumber(x) ein, wobei als Parameter die Ziffer des jeweilig gedrückten Buttons übergeben wird. In der Funktion clear() wird durch die Zeile

display.setText("");

ein Löschen des Text-Feldes veranlaßt.

Alle weiteren evt. noch leeren Funktiongerüste werden nicht benötigt und der besseren Übersicht halber aus dem Quelltext gelöscht. Vor dem Beenden des Editors wird der Quelltext gespeichert (sample.vcm).

Übersetzen und Starten des Applets:

Jetzt kann das Applet erstmals kompiliert werden (Menüpunkt Source-Compile). Davor kann ein Blick auf den von Visual-Coffee erzeugten Quelltext gemacht werden (Source-Edit).

Zwischendurch sollte immer wieder das Projekt zwischengespeichert werden, um Datenverluste zu vermeiden (Project-Save). Spätestens aber sollte jetzt das Project gespeichert werden.

Um das fertige Applet zu testen, muß es mit dem Menüpunkt Source-Compile&Run gestartet werden. Ist im Quelltext kein Tippfehler passiert (d.h. ist der Quelltext kompilierbar), erscheint nach kurzer Zeit das laufende Applet.

Hier können Sie den Quelltext dieses Beispiels sowie einen Screen-Shot der Entwicklungsumgebung mit geladenem Projekt sample.vcp betrachten.