Zend_Pdf-Create.xml 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 15103 -->
  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. ]]>
  32. </programlisting>
  33. </example>
  34. <para>
  35. Das PDF Datei Format unterstützt die schrittweise Aktualisierung von Dokumenten. Jedes Mal,
  36. wenn ein Dokument aktualisiert wird, wird eine neue Revision des Dokuments erstellt. Die
  37. <classname>Zend_Pdf</classname> Komponente unterstützt die Rückgabe einer vorgegebenen Revision des Dokuments.
  38. </para>
  39. <para>
  40. Die Revision kann den Methoden <classname>Zend_Pdf::load()</classname> and
  41. <classname>Zend_Pdf::parse()</classname> als zweiter Parameter übergeben oder durch Aufruf der
  42. <classname>Zend_Pdf::rollback()</classname> Methode.
  43. <footnote>
  44. <para>
  45. Die <classname>Zend_Pdf::rollback()</classname> Methode muss vor einer Änderung eines
  46. Dokuments aufgerufen werden, andernfalls ist das Verhalten nicht definiert.
  47. </para>
  48. </footnote>
  49. Aufruf angefordert werden.
  50. </para>
  51. <example id="zend.pdf.create.example-2">
  52. <title>Rückgabe einer vorgegebenen Revision eines PDF Dokuments</title>
  53. <programlisting role="php"><![CDATA[
  54. ...
  55. // Lade die vorherige Revision des PDF Dokuments
  56. $pdf1 = Zend_Pdf::load($fileName, 1);
  57. // Lade die vorherige Revision des PDF Dokuments
  58. $pdf2 = Zend_Pdf::parse($pdfString, 1);
  59. // Lade die erste Revision des PDF Dokuments
  60. $pdf3 = Zend_Pdf::load($fileName);
  61. $revisions = $pdf3->revisions();
  62. $pdf3->rollback($revisions - 1);
  63. ...
  64. ]]>
  65. </programlisting>
  66. </example>
  67. </sect1>
  68. <!--
  69. vim:se ts=4 sw=4 et:
  70. -->