Zusatzfunktionen
Überlaufcontainer

Überlaufcontainer sind Container, denen ein an anderer Stelle bereits verwendetes Plug-in erneut zugewiesen wurde. Das Plug-in kann dann den Inhalt, der nicht mehr in den ersten Container passt, in einem oder mehreren Containern fortsetzen.

Hinweis: Das Plug-in muss diesen Überlaufmodus unterstützen. Derzeit unterstützt nur das Legendenplug-in diesen Modus.

Beispiel: Auf der ersten Seite ist ein Container 'Legende1' definiert. Allerdings kann die Legende bei einer großen Anzahl von angeschalteten Ebenen zu groß für den ersten Container werden und wird dann entsprechend abgeschnitten. Um trotzdem eine vollständige Legende zu erhalten kann ein zweites Dokument (neue Seite) hinzugefügt werden. Dieses bekommt einen Container 'Legende 2' und diesem Container wird dann das bereits am Container 'Legende 1' zugewiesene Legendenplug-in erneut zugewiesen (Kontextmenü am Container -> Plug-in mehrfach zuweisen -> Legende).

ueberlauflegende.png

Dies kann auch über mehrere Seiten fortgesetzt werden.

Hinweis: Damit keine leeren Seiten im Ausdruck entstehen, kann die Option 'Ausblenden wenn leer' am Container verwendet werden.
Beachten Sie weiterhin, 'Höhe nach Inhalt' sich nicht mit dem Überlaufcontainer verträgt. Vergeben Sie immer am Container eine feste Höhe.
Import/Export/Kopieren

Import/Export einer Vorlage

kontextmenü_vorlage.png      kontextmenü_vorlage_2.png

Vorlagen können exportiert und importiert werden. (Hinweis: beabsichtigen Sie die gleiche Vorlage wieder zu importieren, müssen Sie die ID der Druckvorlage verändern, weil sonst kein Import möglich ist (die importierte Vorlage hätte dann die gleiche ID!))

Die IDs können auf zwei Seiten angepasst werden:

  • im Reiter Vorlage im Eigenschaftendialog einer Druckvorlage unter Allgemein/ID (Beachten Sie, wenn die Vorlage unter aktuelle Vorlage geöffnet ist, wird die geänderte ID nicht übernommen, ändern Sie dann wie im nächsten Punkt beschrieben die ID und speichern die Änderungen ab!)
  • im Reiter aktuelle Vorlage ebenfalls im Eigenschaftendialog unter Allgemein/ID

Achtung: folgende Fehlermeldung kann beim Import hervorgerufen werden:

Fehlermeldung: Es existiert bereits eine Vorlage mit dieser ID, der Import wird abgebrochen!

Diese Meldung erscheint, wenn beim Import einer Druckvorlage die importierte und eine bereits bestehende Druckvorlage die gleiche ID besitzen. Ändern Sie die ID der bestehenden Druckvorlage!

Kopieren und Einfügen einer Vorlage

Vorlagen können über das Kontextmenü kopiert und eingefügt werden. Die neue Vorlage erhält dann den Namen Kopie von ... der dann im Eigenschaftsdialog der Druckvorlage verändert werden kann.

Ausblenden, wenn leer

Container Eigenschaft:

Ausblenden, wenn leer: Der Container wird nicht angezeigt, wenn er keinen Inhalt hat. Wenn ein Container ein Plugin enthält, entscheidet dieses ob Inhalt vorhanden ist. Das Legendenplugin hat z. B. keinen Inhalt, wenn keine Symboleinträge vorhanden sind, das Lizenztextplugin, wenn es keine Lizenztexte an den angeschalteten Ebenen gibt.


Enthält ein Container Untercontainer, werden diese wiederum rekursiv auf Inhalt überprüft. Wird festgestellt, dass es keinen Inhalt gibt, wird der Container incl. Rahmen und Hintergrundfarbe ausgeblendet.

Hinweis: Der Platz ausgeblendeter Container wird nicht freigegeben.

Ein Dokument wird nur dann erzeugt, wenn es einen Container enthält. Besteht ein Dokument aus Containern, die dynamischen Inhalt haben und u. U. leer bleiben, dann sollten diese entsprechend die Option 'Ausblenden wenn leer' gesetzt bekommen.

Beispiel - Leere Seiten bei Überlauflegende verhindern: Wurde ein zweites Dokument an der Vorlage definiert, welches einen Container für eine Überlauflegende aufnimmt, dann sollte dieser Container die Option 'Ausblenden wenn leer' bekommen. Gibt es keinen Überlauf der Legende auf die zweite Seite, wird der Legendencontainer ausgeblendet und die komplette zweite Seite beim Erzeugen des PDF-Dokumentes ignoriert, da es keinen Container mit Inhalt gibt.

programmierte Vorlagen

Für HQPrint.net gibt es die Möglichkeit, Vorlagen direkt in C# zu programmieren. Dieser Vorlagen sind allerdings nicht kompatibel zum Designer und werden nur IDU-intern in Fachanwendungen verwendet, da sie speziell für das Erzeugen von mehrseitigen Dokumenten mit Tabellen (Reports) einige zusätzliche Funktionen mitbringen.

Wird in einem Modul solch eine programmierte Vorlage verwendet, dann gibt es die Möglichkeit, Textblöcke und Bilder kundenspezifisch vorzubelegen:

HQPrint.net Vorlageninhalte vorbelegen

Die Inhalte der für HQPrint.net definierten Vorlagen können über eine XML-Datei vorbelegt werden. Ist zum Beispiel ein Textblock Anschrift in der Vorlage definiert, so kann die Standard-Anschrift geändert werden, indem eine XML-Datei im entsprechenden Format in das Konfigurationsverzeichnis der Vorlage gelegt wird.

Der letztendlich im PDF-Dokument angezeigte Text wird immer nach folgendem Schema ermittelt (hier am Beispiel Anschrift):

  • fest definierte Anschrift direkt aus der Vorlage
  • Anschrift aus einer (optionalen) XML-Datei (überschreibt wenn vorhanden die Anschrift aus der Vorlage)
  • vom Benutzer angepasste Anschrift (falls der Benutzer die Anschrift im Druckdialog angepasst hat, wird immer seine letzte Eingabe verwendet und überschreibt die oben ermittelte Anschrift)

XML-Vorbelegungsdatei erstellen

Verwenden Sie bitte folgende Vorlage als Ausgangsdatei und passen Sie diese entsprechend an. Derzeit können Textblöcke und Pfade zu Bilddateien vorbelegt werden. Genauere Hinweise zur Anpassung der Datei finden Sie als Kommentare in der Vorlage.

Die fertig angepasste Vorlage müssen Sie in das Konfigurationsverzeichnis der HQPrint.net-Vorlage kopieren. Dieses befindet sich unter <IhrProjekt>\IISVirtualDir\HQPrint.net\<ID der Vorlage>.

Container anordnen

Unter Umständen kann es dazu kommen, dass bestimmte Elemente von anderen im pdf Ausdruck überdeckt werden (bspw. Koordinatenraster wird zuerst gezeichnet und Karte darüber). Hierbei ist es notwendig die Container entsprechend der Zeichenreihenfolge neu zu sortieren.

Mit Drag-and-drop kann die Reihenfolge der Container entspechend angepasst werden. (Hier Container Legende wird als Untercontainer vom Container Karte in den Container Kartenrahmen verschoben).

beispiel_container03.png

Bsp. Kartenrahmen verdeckt durch Kartenbild im pdf Ausdruck

beispiel_container02.png

angepasste Reihenfolge der Container (Problem war in diesem Beispiel weiterhin, dass die Legende ebenfalls durch die Karte verdeckt wurde. Daher wurde Karte und Kartenrahmen vom "Rest" getrennt.)

beispiel_container01.png