Zend_Pdf-Create.xml 2.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. <sect1 id="zend.pdf.create">
  2. <title>Tworzenie oraz ładowanie dokumentów PDF.</title>
  3. <para>
  4. Klasa <code>Zend_Pdf</code> reprezentuje dokument PDF i zapewnia funkcjonalność
  5. na poziomie dokumentu.
  6. </para>
  7. <para>
  8. W celu utworzenia nowego dokumentu trzeba utworzyć obiekt <code>Zend_Pdf</code>.
  9. </para>
  10. <para>
  11. Klasa <code>Zend_Pdf</code> zapewnia także dwie statyczne metody do ładowania
  12. istniejącego dokumentu PDF. Te metody to <code>Zend_Pdf::load()</code> oraz
  13. <code>Zend_Pdf::parse()</code>. Obie zwracają obiekt Zend_Pdf lub wyrzucają
  14. wyjątek, jeśli wystąpi błąd.
  15. </para>
  16. <example id="zend.pdf.create.example-1">
  17. <title>Tworzenie nowego lub ładowanie istniejącego dokumentu PDF.</title>
  18. <programlisting role="php"><![CDATA[
  19. ...
  20. // Utwórz nowy dokument PDF.
  21. $pdf1 = new Zend_Pdf();
  22. // Załaduj dokument PDF z pliku.
  23. $pdf2 = Zend_Pdf::load($fileName);
  24. // Załaduj dokument PDF z łańcucha znaków.
  25. $pdf3 = Zend_Pdf::parse($pdfString);
  26. ...
  27. ]]>
  28. </programlisting>
  29. </example>
  30. <para>
  31. Format pliku PDF obsługuję inkrementalne uaktualnianie dokumentu. Wtedy za
  32. każdym razem gdy dokument jest uaktualniony, tworzona jest nowa wersja
  33. dokumentu. Moduł Zend_Pdf umożliwia następnie ładowanie określonej wersji
  34. dokumentu.
  35. </para>
  36. <para>
  37. Wersja może być określona jako drugi parametr w metodach <code>Zend_Pdf::load()</code>
  38. oraz <code>Zend_Pdf::parse()</code> lub za pomocą wywołania <code>Zend_Pdf::rollback()</code>
  39. <footnote>
  40. <para>
  41. Metoda <code>Zend_Pdf::rollback()</code> musi być wywołana przed
  42. jakimikolwiek zmianami. W przeciwnym wypadku zachowanie nie jest
  43. zdefiniowane.
  44. </para>
  45. </footnote>
  46. </para>
  47. <example id="zend.pdf.create.example-2">
  48. <title>Ładowanie określonej wersji dokumentu PDF.</title>
  49. <programlisting role="php"><![CDATA[
  50. ...
  51. // Załaduj poprzednią wersję dokumentu PDF.
  52. $pdf1 = Zend_Pdf::load($fileName, 1);
  53. // Załaduj poprzednią wersję dokumentu PDF.
  54. $pdf2 = Zend_Pdf::parse($pdfString, 1);
  55. // Załaduj pierwszą wersję dokumentu PDF.
  56. $pdf3 = Zend_Pdf::load($fileName);
  57. $revisions = $pdf3->revisions();
  58. $pdf3->rollback($revisions - 1);
  59. ...
  60. ]]>
  61. </programlisting>
  62. </example>
  63. </sect1>