Zend_Pdf-Create.xml 2.8 KB

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