Die PageView ist die zentrale Anzeigekomponente innerhalb der jadice® document platform. Sie
übernimmt die Verwaltung, Handhabung und Darstellung von Dokumenten und
Seiten.
Zur Darstellung erhalt die PageView eine Document-Referenz. Über
entsprechende Methoden kann eine Referenz auf angezeigte Dokument erhalten
beziehungsweise diese verändert werden. Folgende Methoden können in diesem
Zusamenhang verwendet werden:
getDocument()Diese Methode liefert eine Referenz auf das aktuell angezeigte Dokument. Der Aufruf dieser Methode kann jederzeit unabhängig vom Swing Event Dispatch Thread stattfinden.
setDocument(...)Diese Methode ändert das anzuzeigende Dokument. Der Aufruf dieser Methode muss zwingend auf dem Swing Event Dispatch Thread stattfinden.
cleanup()Diese Methode entfernt das Dokument. Der Aufruf dieser Methode kann jederzeit unabhängig von Swing Event Dispatch Thread stattfinden.
Eigenschaften der Klasse Document sind in „Dokumente in jadice®“ beschrieben.
Eine PageView-Instanz kann immer genau ein Dokument darstellen. Dieses kann dem
PageViewunabhängig von seinem Ladezustand übergeben werden. Änderungen am
Dokument erkennt der PageView selbstständig und führt entsprechende Updates der
Anzeige durch.
Registrierte Listener, zum Beispiel die integrierende Anwendung, werden über
wichtige Änderungen der PageView beziehungsweise der Darstellung des Dokuments
informiert.
Dies geschieht unter Verwendung von PropertyChangeEvents
beziehungsweise PropertyChangeListeners.[4] Interessenten melden sich als
PropertyChangeListener qualifiziert (genau für eine
definierte Eigenschaft) oder unqualifiziert (für alle Eigenschaften) bei der
jeweiligen PageView-Instanz an. Zur konkreten Identifizierung der betreffenden
Property sind Eigenschaftsnamen in PageView als öffentliche Konstanten
deklariert.
Als JComponent kann der PageView direkt in eine
Swing-Komponentenhierarchie eingebettet werden. Im Regelfall empfiehlt es sich
jedoch, stattdessen den komfortableren BasicViewer zu verwenden.
Zusätzlich zu der reinen Dokumenten-Ansicht ermöglicht die PageView selbst
definierte Werkzeuge an die PageView anzudocken, um Beiträge zu der
Dokumentdarstellung oder weitere Funktionen bereit zu stellen. Weitere Informationen
zu Tools entnehmen Sie bitte „Tools“.
[4] Siehe dazu auch PropertyChangeEvent und PropertyChangeSupport in der Java 2 Platform API Specification
