CIB pdf toolbox technischer Leitfaden (DE)
17. Prüfschablonen verwenden
Mit Prüfschablonen ist es möglich zu prüfen, ob eine PDF Seite Inhalt enthält, an welcher Stelle und ob der Inhalt an dieser Stelle erlaubt bzw. zwingend erforderlich oder aber unerwünscht ist.
Die zu setzenden, speziellen Properties werden im Folgenden näher beschrieben.
Propertybezeichnung |
Typ |
Funktionalität |
CheckMask (ab CIB pdf toolbox |
String |
Beschreibt den Aufbau der konkreten Prüfschablonen. Die einzelnen Komponenten werden im Weiteren genauer beschrieben. Aufbau: <Checkmasklist> ::= <Checkmask> | <Checkmask> „;“ <Checkmasklist> Es können mehrere Definitionen für Prüfschablonen aneinandergereiht werden. Sie werden durch Semikolon getrennt. Beispiel: CheckMask=“{{1,3-40}; {forbidden;2cm;2cm;5cm;4cm}}; {{2,5,6};{allowed;2cm;2cm;5cm;4cm};{mandatory;1cm;1cm;6cm;7cm}};“ |
<Checkmask>
|
String |
Beschreibung einer Schablone. Aufbau: Für die Seiten, für die eine Prüfschablone angewendet werden soll, werden die Schablonen-Bereiche beschrieben. Pro <Checkmask> können wahlweise „allowed“, „forbidden“ oder „mandatory“ Bereiche oder auch Kombinationen dieser Bereiche beschrieben werden. |
<mask area> |
|
Beschreibung des Prüfschablonen-Bereichs (Rechteck). Aufbau: Forbidden In diesem Rechteck darf kein Text stehen Allowed In diesem Rechteck darf Text stehen Mandatory In diesem Rechteck muss Text stehen
left;top Koordinaten des linken, oberen Eckpunktes des Rechteckes (siehe in Grafik der Punkt A) right;bottom Koordinaten des rechten, unteren Eckpunktes des Rechteckes (siehe in Grafik der Punkt B) ID Angabe eines Bezeichners(ID) der in den CheckMaskViolations mit ausgegeben wird Bezugspunkt für die Koordinaten ist die linke, obere Ecke der Seite. Durch Eingabe von negativen Werten kann der Bezugspunkt auf die rechte untere Ecke der Seite geändert werden. Unterstützt werden die Einheiten: mm, cm, in, ft; Default: mm |
<Pages> |
|
Angabe der Seiten oder Seitenbereiche, auf denen die folgende Prüfschablone angebracht werden soll.
Aufbau: First (nur erste Seite), NoFirst (nicht erste Seite), Last (nur letzte Seite), NoLast (nicht letzte Seite), Even (gerade Seiten) Odd (ungerade Seiten) All (alle Seiten) Wert (diese Seite) Wert1-Wert2 (diesem Seitenbereich) Wert1-Wert2[,]Wert3 (diesen Seiten/Seitenbereich)
|
CheckMaskViolations |
String |
Property liefert die Verletzungen der Prüfschablonen zurück. Es wird ausgegeben: Position der Checkmask, die verletzt wird (masks).
Beispiel: …{forbidden;50mm,50mm,150mm,100mm;myid1}. Violations={{content;49.31;52.84;61.66;50.08;};{masks;{50;50;150;100;myid1}}} Ausgabe im Trace: Beispiel: CheckMask: Content is placed on the forbidden area [forbidden;0mm;0mm;150cm;100mm;myid01]. |
CheckMaskThreshold |
String |
Ermöglicht das Einstellen einer Fehlertoleranz. Der Wert gibt an wieviele Pixel in einem „verbotenen“ Checkmaskbereich toleriert werden, ohne eine Verletzung auszulösen. Angegeben werden können Ganzzahlen: Default: 1 |
StopOnFirstCheckmaskViolation |
String |
Gibt an, ob bei der ersten auftretenden Verletzung abgebrochen werden soll. Die Verletzung wird in der Property CheckmaskViolations gespeichert. Mögliche Werte: 0: Es wird nicht abgebrochen (default) 1: Es wird abgebrochen |
StopAfterCheckmaskViolation |
String |
Prüft das gesamte Dokument und speichert alle Verletzungen in der Property und gibt eine Fehlermeldung zurück. Mögliche Werte: 0: Keine Fehlermeldung 1: Fehlermeldung und Speichern aller Verletzungen |