1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82
|
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.pdf.create">
<title>Erstellen und Laden von PDF Dokumenten</title>
<para>
Die <classname>Zend_Pdf</classname> Klasse bildet das <acronym>PDF</acronym> Dokument ab
und stellt Operationen auf Dokumentebene bereit.
</para>
<para>
Um ein neues Dokument zu stellen, sollte zuerst ein neues <classname>Zend_Pdf</classname>
Objekt erstellt werden.
</para>
<para>
Die <classname>Zend_Pdf</classname> Klasse stellt zwei statische Methoden zum Laden von
bestehenden <acronym>PDF</acronym> Dokumenten bereit. Dies sind die
<methodname>Zend_Pdf::load()</methodname> und <methodname>Zend_Pdf::parse()</methodname>
Methoden. Beide geben als Ergebnis <classname>Zend_Pdf</classname> Objekte zurück oder
werfen eine Ausnahme, wenn ein Fehler auftritt.
</para>
<example id="zend.pdf.create.example-1">
<title>Erstellen und Laden von PDF Dokumenten</title>
<programlisting language="php"><![CDATA[
...
// Erstelle ein neues PDF Dokument
$pdf1 = new Zend_Pdf();
// Lade ein PDF Dokument aus einer Datei
$pdf2 = Zend_Pdf::load($fileName);
// Lade ein PDF Dokument aus einer Zeichenkette
$pdf3 = Zend_Pdf::parse($pdfString);
...
]]></programlisting>
</example>
<para>
Das <acronym>PDF</acronym> Datei Format unterstützt die schrittweise Aktualisierung von
Dokumenten. Jedes Mal, wenn ein Dokument aktualisiert wird, wird eine neue Revision des
Dokuments erstellt. Die <classname>Zend_Pdf</classname> Komponente unterstützt die Rückgabe
einer vorgegebenen Revision des Dokuments.
</para>
<para>
Die Revision kann den Methoden <methodname>Zend_Pdf::load()</methodname> und
<methodname>Zend_Pdf::parse()</methodname> als zweiter Parameter übergeben oder durch Aufruf
der <methodname>Zend_Pdf::rollback()</methodname> Methode.
<footnote>
<para>
Die <methodname>Zend_Pdf::rollback()</methodname> Methode muss vor einer Änderung
eines Dokuments aufgerufen werden, andernfalls ist das Verhalten nicht definiert.
</para>
</footnote>
Aufruf angefordert werden.
</para>
<example id="zend.pdf.create.example-2">
<title>Rückgabe einer vorgegebenen Revision eines PDF Dokuments</title>
<programlisting language="php"><![CDATA[
...
// Lade die vorherige Revision des PDF Dokuments
$pdf1 = Zend_Pdf::load($fileName, 1);
// Lade die vorherige Revision des PDF Dokuments
$pdf2 = Zend_Pdf::parse($pdfString, 1);
// Lade die erste Revision des PDF Dokuments
$pdf3 = Zend_Pdf::load($fileName);
$revisions = $pdf3->revisions();
$pdf3->rollback($revisions - 1);
...
]]></programlisting>
</example>
</sect1>
|