documentation/manual/zh/module_specs/Zend_Pdf-Create.xml

   1 <sect1 id="zend.pdf.create">
   2     <title> 生成和加载 PDF 文档 </title>
   3     <para>
   4        <code>Zend_Pdf</code> 类描绘 PDF 文档自己和提供文档一级的功能。
   5     </para>
   6
   7     <para>
   8         要生成新文档，需要创建 <code>Zend_Pdf</code> 对象。
   9     </para>
  10
  11     <para>
  12         <code>Zend_Pdf</code> 类也提供两个静态方法来加载 PDF，<code>Zend_Pdf::load()</code> 和 <code>Zend_Pdf::parse()</code>。它们都返回 Zend_Pdf 对象作为结果或如果有错误发生就抛出异常。
  13     </para>
  14
  15     <example id="zend.pdf.create.example-1">
  16         <title> 生成新的或加载 PDF 文档 </title>
  17         <programlisting role="php"><![CDATA[
  18 ...
  19 // Create new PDF document.
  20 $pdf1 = new Zend_Pdf();
  21
  22 // Load PDF document from a file.
  23 $pdf2 = Zend_Pdf::load($fileName);
  24
  25 // Load PDF document from a string.
  26 $pdf3 = Zend_Pdf::parse($pdfString);
  27 ...
  28 ]]>
  29       </programlisting>
  30     </example>
  31
  32     <para>
  33         PDF 文件格式支持增量式文档更新。这样每次文档更新，就产生新的版本。Zend_Pdf 模块支持指定版本的读取。
  34     </para>
  35     <para>
  36        版本可以指定为 <code>Zend_Pdf::load()</code> 和 <code>Zend_Pdf::parse()</code>的第二个参数或由 <code>Zend_Pdf::rollback()</code> 来请求。
  37         <footnote>
  38             <para>
  39                 <code>Zend_Pdf::rollback()</code> 方法必需在任何修改前调用，否则它的行为就没有定义。
  40             </para>
  41         </footnote>
  42     call.
  43     </para>
  44
  45     <example id="zend.pdf.create.example-2">
  46         <title> 请求 PDF 文档的指定版本 </title>
  47         <programlisting role="php"><![CDATA[
  48 ...
  49 // Load PDF previouse revision of the document.
  50 $pdf1 = Zend_Pdf::load($fileName, 1);
  51
  52 // Load PDF previouse revision of the document.
  53 $pdf2 = Zend_Pdf::parse($pdfString, 1);
  54
  55 // Load first revision of the document.
  56 $pdf3 = Zend_Pdf::load($fileName);
  57 $revisions = $pdf3->revisions();
  58 $pdf3->rollback($revisions - 1);
  59 ...
  60 ]]>
  61         </programlisting>
  62     </example>
  63
  64
  65 </sect1>
  66 <!--
  67 vim:se ts=4 sw=4 et:
  68 -->