Seitenvergleich

Problem:

Die Zoom-to-Fit-Buttons funktionieren nicht, sind aber trotzdem aktiviert. Andere Zoom-Funktionalitäten sind funktionsfähig (z. B. der Zoom auf einen festen Prozentwert).

...

Gleiches gilt für das Zoom Snap-In:

Möglicher Grund:

Presentation Rules sind nicht gesetzt.

...

Anwendungsbeispiel: JadiceDemoApplication.initialiseGUI()

Hintergrundinformationen

PresentationRules

Die Instanzen von PresentationRule erlauben das Anpassen der Seitenanzeige als Reaktion auf verschiedene Events. Konkret handelt es sich dabei um die folgenden vier Events, die in jeweils eigenen Methoden-Implementationen behandelt werden können:

...

Das Setzen von PresentationRules erlaubt somit vielfältige Anpassungen des Verhaltens der Seitenanzeige. Die oben genannten Implementierungen haben folgende Aufgaben:

...

Einpassen, die Fit Modi

Einpassen als Funktion ist verbunden mit den Fragen:

• Was wird eingepasst? und
• Was ist die Referenz, worin wird eingepasst?

Die jadice Funktionen "Einpassen" und deren zugrunde liegende Berechnungen, beziehen sich auf das Einpassen genau einer Seite, konkret der jeweils aktuellen Seite, in die Viewportgröße der PageView. Das heißt, die Berechnung liefert die Skalierung der aktuellen Seite eingepasst in den kompletten sichtbaren Bereich der PageView. Ein Bezug oder eine Relation auf die Gesamtheit der Seiten im Dokument oder andere sichtbare Seiten, ist nicht Teil der Funktionsumfangs. Als solches sind diese Funktionen ausgelegt für die ausschließliche Verwendung im SinglePageLayout.(siehe auch Hinweis unten)

Die "Einpassen"-Funktionen werden in jadice als Modus angeboten. Das bedeutet, dass nicht nur ein einmaliges Fitting einer bestimmten Seite in den Viewport erfolgt, sondern dass diese Einpassung bei Wechsel der aktuellen Seite erneut durchgeführt werden soll, solange der Modus aktiv ist. Dies ist insbesondere für Dokumente mit extrem unterschiedlichen Seitengrößen gedacht.

Durch die Nutzung von Mehrseiten-Layouts wird dem jeweils aktiven Layout die Hoheit über die Positionierung und Skalierung der Seiten übergeben. Dies kollidiert mit dem Einzelseiten-Einpassen und Modus Verhalten, dass eine Skalierung und Positionierung einer bestimmten Seite vorgeben will. In dieser konkurrierenden Situation kann es zu unerwarteten Effekten kommen. Ein zuverlässiges Darstellungsverhalten kann nicht zugesichert werden.

Aus diesem Grund existieren die zwei mitgelieferten Presentation Rules:

• com.levigo.jadice.swing.pageview.ApplyDynamicZoomRule
  • Sorgt dafür, dass die Auswahl eines Dynamic eines Dynamic Zoom Mode (ein ›Anpassen‹-Modus) auch tatsächlich dazu führt, dass die Seitenanzeige angepasst wird. So wird beispielsweise bei jedem Seitenwechsel erneut die tatsächliche Seitengröße und der Skalierungsfaktor berechnet, wie groß die Seite dargestellt werden muss, um nach der festgelegten Vorgabe anzupassen, z. B. "Breite anpassen".. Nachfolgend muss die Seite für die berechneten Faktoren ggf. aufbereitet und neu gerendert werden.
• com.levigo.jadice.swing.pageview.SwitchToSinglePageOnFit
  • Wechselt bei Auswahl eines Dynamic Zoom Mode (ein ›Anpassen‹-Modus) auf das Einzelseiten-Layout
    Wie oben beschrieben ist der dynamische Zoom ausgelegt für die Verwendung im Einzelseiten-Layout. Zur Sicherstellung der Funktionsweise, existiert die Presentation Rule SwitchToSinglePageOnFit. Diese muss zwingend registriert werden, wenn der dynamische Zoom korrekt genutzt werden soll.