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.