Zend_Pdf-Create.xml 2.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 15103 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.pdf.create">
  5. <title>Creando y Cargando Documentos PDF</title>
  6. <para> La clase <classname>Zend_Pdf</classname> representa documentos PDF y
  7. proporciona operaciones a nivel de documento. </para>
  8. <para> Para crear un nuevo documento, primero debe ser creado un nuevo
  9. objeto <classname>Zend_Pdf</classname>. </para>
  10. <para> La clase <classname>Zend_Pdf</classname> también ofrece dos métodos
  11. estáticos para cargar un documento PDF. Estos métodos son
  12. <classname>Zend_Pdf::load()</classname> y
  13. <classname>Zend_Pdf::parse()</classname>. Ambos retornan objetos
  14. <classname>Zend_Pdf</classname> como resultado o arrojan una
  15. excepción si ocurre un error. </para>
  16. <example id="zend.pdf.create.example-1">
  17. <title>Crear un nuevo documento PDF o cargar uno ya esistente.</title>
  18. <programlisting language="php"><![CDATA[
  19. ...
  20. // Crear un nuevo documento PDF
  21. $pdf1 = new Zend_Pdf();
  22. // Cargar un documento PDF desde un archivo
  23. $pdf2 = Zend_Pdf::load($fileName);
  24. // Cargar un documento PDF desde un string
  25. $pdf3 = Zend_Pdf::parse($pdfString);
  26. ...
  27. ]]></programlisting>
  28. </example>
  29. <para> El formato de archivos PDF soporta la actualización incremental del
  30. documento. Así, cada vez que un documento es actualizado, entonces se
  31. crea una nueva revisión del documento. El componente
  32. <classname>Zend_Pdf</classname> soporta la recuperación de una
  33. revisión especificada. </para>
  34. <para> Una revisión puede especificarse como un segundo parámetro a los
  35. métodos <classname>Zend_Pdf::load()</classname> y
  36. <classname>Zend_Pdf::parse()</classname> o requerirlo llamando al
  37. método <classname>Zend_Pdf::rollback()</classname>. <footnote>
  38. <para> El método <classname>Zend_Pdf::rollback()</classname> debe
  39. ser invocado antes de aplicar cualquier cambio al documento, de
  40. lo contrario el comportamiento no está definido. </para>
  41. </footnote> call. </para>
  42. <example id="zend.pdf.create.example-2">
  43. <title>Requiriendo Revisiones Específicas de un documento PDF</title>
  44. <programlisting language="php"><![CDATA[
  45. ...
  46. // Cargar la revisión anterior del documento PDF
  47. $pdf1 = Zend_Pdf::load($fileName, 1);
  48. // Cargar la revisión anterior del documento PDF
  49. $pdf2 = Zend_Pdf::parse($pdfString, 1);
  50. // Cargar la primera revisión del documento PDF
  51. $pdf3 = Zend_Pdf::load($fileName);
  52. $revisions = $pdf3->revisions();
  53. $pdf3->rollback($revisions - 1);
  54. ...
  55. ]]></programlisting>
  56. </example>
  57. </sect1>