Die Funktion :neighbour[]

Die Funktion :neighbour[] erlaubt die Auswahl einzelner Bilder innerhalb von Bildgruppen. Die jeweiligen Bildgruppen müssen durch eine entsprechende Image-Vereinbarung innerhalb eines item-Kommandos definiert sein. Innerhalb der Bildgruppe ermöglicht :neighbour[] die Adressierbarkeit in dem Sinne, daß das erste oder das letzte Bild innerhalb der Gruppe oder das dem aktuellen Bild unmittelbar vorangehende oder nachfolgende Bild ausgewählt werden können.

Die Funktion gehorcht folgender Sytnax: :neighbour[:element,Schlüsselwort1,Schlüsselwort2]

Das Element muß dem Datentyp image entsprechen. Als erste Schlüsselworte können previous, next, last und first eingesetzt werden. Das zweite Schlüssselwort ist optional und kann group oder document lauten. Folgende Tabelle erläutert die Funktion bei Euínsatz von group als zweitem Schlüsselwort:

Schlüsselwort
Bildgruppe
Bildfolge
(image-items)




xyz
009
first
xzz
001

xzz
002
previous
xzz
003
group
xzz
004
next
xzz
005

xzz
006

xzz
007
last
xzz
008

xzy
001


Durch eine Imagedefinition seien acht Bilder zur Bildgruppe "xzz" zusammengefaßt. Durch eine bestimmte Datenbankabfrage wird ein Bild ausgewählt, welches der Nummer "004" innerhalb der Bildgruppe entsprecht. Durch Einsatz der Funktion :neighbour[] ist es nun möglich, innerhalb der Bildgruppe ausgehend von diesem Bild weitere Bilder zu adressieren.

Die Angabe :neighbour[:bildnummer,first,group] adressiert hier das erste Bild innerhalb der Bildgruppe. Analog dazu würde last das letzte Bild auswählen, während  previous und next das jeweils vorherhige oder nachfolgende ansteuern.