Java-Applet: Viewer / Dokumentation

Das Applet Viewer ist eine Erweiterung des Applets Chooser und besitzt ähnliche Leistungsmerkmale. Es erzeugt einen Navigationsbaum, über den eine große Anzahl Bilder ausgewählt und dargestellt werden können (Die Darstellung erfolgt im Applet). Zoomfunktionen gestatten die Vergrößerung und das Verschieben des Bildausschnitts. Die Kreuzverlinkung der Bilder erfolgt wie beim Applet Chooser.

Die Steuerung des Applets erfolgt über folgende Parameter:

Parameter Typ Defaultwert Beschreibung
FgColor Hexadezimal
(RGB)
000000 Schriftfarbe
BgColor FFFFFF Hintergrundfarbe
FgSelColor FFFFFF Schriftfarbe des ausgwählten Menüeintrags
BgSelColor 003399 Hintergrundfarbe des ausgwählten Menüeintrags
FontSize Integer 12 Schriftgröße
FontHeight Integer 24 Zeilenhöhe
FontStyle Zeichenkette plain Schriftstil: bold, italic oder bold-italic
PreSelect Integer -1 Vorausgewählte Zeile im Navigationsbaum
TreeWidth Integer 200 Breite des Navigationsbaums in Pixel
BufferSize Integer 2 Anzahl der simultan im Speicher gehaltenen Bilder
LookNFeel Zeichenkette windows Look and Feel festlegen: windows, metal, motif
Root Zeichenkette - Wurzel des Navigationbaums
(keine Wurzel wenn der Parameter fehlt)
Tree Zeichenkette  - Aufbau des Navigationbaums
(dieser Parameter ist zwingend erforderlich!)
OpenIcon Zeichenkette - Icon für den geöffneten Ordner
ClosedIcon Zeichenkette - Icon für den geschlossenen Ordner
LeafIcon Zeichenkette - Icon für HTML-Seiten
SelectedIcon Zeichenkette - Icon für die zuletzt ausgewählte HTML-Seite
FolderSound Zeichenkette - Klang beim Auftreten eines Fehlers
ErrorSound Zeichenkette - Klang beim Öffnen/Schließen eines Ordners

Die Zeichenkette "Tree" beinhaltet den darzustellenden Navigationsbaum, sowie die Adressen der verknüpten Bilder. Der Navigationsbaum besteht aus Knoten (Ordner) und Blättern (Bilder vom Typ JPG oder GIF). In "Tree" steht für jeden Knoten und jedes Blatt ein Eintrag, der mit einem Semikolon abgeschlossen wird. Knoten und Blätter werden dadurch unterschieden, dass Knoten immer mindestens ein untergeordnetes Element (Knoten und/oder Blatt) besitzen. Untergeordnete Elemente werden in den folgenden Zeilen durch vertikale Striche in den ersten Spalten markiert:

Ordner 1;
|Ordner 1.1;
||Blatt 2.1, Titel 2.1, blatt21.jpg, 1;
||Blatt 2.2, Titel 2.2, blatt22.jpg, 1;
||Blatt 2.3, Titel 2.3, blatt23.jpg, 1;
|Blatt 1.2,  Titel 1.2, blatt12.jpg, 1;
|Blatt 1.3,  Titel 1.3, blatt13.jpg, 1;
Blatt 2,     Titel 2,   blatt2.jpg,  1;

Sowohl für Knoten als auch Blätter können 4 Parameter übergeben werden; der erste Parameter ist der Texteintrag im Navigationsbaum, der zweite ist der Bildtitel unter dem Bild, der dritte ist der Datei-Pfad des Bildes und der vierte ist eine Integerzahl, die eine Kreuzverknüpfung der Bilder gestattet. Diese Integerzahl kann folgende Werte annehmen:

Wert Bedeutung
1 Der 3. Parameter ist die Adresse eine Bilddatei (*.jpg oder *.gif).
1 Der 3. Parameter ist der 1. Teil der Adresse einer Bilddatei.
2 Der 3. Parameter ist der 2. und letzte Teil der Adresse einer Bilddatei.
−2 Der 3. Parameter ist der 2. Teil der Adresse einer Bilddatei.
3 Der 3. Parameter ist der 3. und letzte Teil der Adresse einer Bilddatei.

Der HTML-Code für die Kreuzverknüpfung im linken Frame befindet sich auf der folgenden Seite.

Die Default-Icons für Knoten und Blätter sind abhängig von der jeweiligen Look-And-Feel-Einstellung. Knoten und Blätter sowie die Klänge können davon unabhängig über Parameter geändert werden (s.o.). In dem Jar-File "viewer.jar" sind einige Beispiele für Icons und Klänge enthalten (s. folgende Tabelle).

Verzeichnis Dateiname Bedeutung
bitmap closed-blau.gif geschlossenes Verzeichnis
closed-gelb.gif
open-blau.gif geöffneter Ordner
open-gelb.gif
leaf-weiss.gif HTML-Seite
leaf-gelb.gif
selected-weiss.gif ausgwählte HTML-Seite
selected-gelb.gif
klaenge UtopiaFehler.wav Geräusch bei einem Fehler
UtopiaOeffnen.wav Geräusch beim Öffnen/Schließen eines Ordners

letzte Änderung: Samstag, 10. Dezember 2005