File: Zend_Pdf-Create.xml

package info (click to toggle)
zendframework 1.12.9%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie-kfreebsd
  • size: 133,584 kB
  • sloc: xml: 1,311,829; php: 570,173; sh: 170; makefile: 125; sql: 121
file content (82 lines) | stat: -rw-r--r-- 2,891 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.pdf.create">
    <title>Erstellen und Laden von PDF Dokumenten</title>

    <para>
        Die <classname>Zend_Pdf</classname> Klasse bildet das <acronym>PDF</acronym> Dokument ab
        und stellt Operationen auf Dokumentebene bereit.
    </para>

    <para>
        Um ein neues Dokument zu stellen, sollte zuerst ein neues <classname>Zend_Pdf</classname>
        Objekt erstellt werden.
    </para>

    <para>
        Die <classname>Zend_Pdf</classname> Klasse stellt zwei statische Methoden zum Laden von
        bestehenden <acronym>PDF</acronym> Dokumenten bereit. Dies sind die
        <methodname>Zend_Pdf::load()</methodname> und <methodname>Zend_Pdf::parse()</methodname>
        Methoden. Beide geben als Ergebnis <classname>Zend_Pdf</classname> Objekte zurück oder
        werfen eine Ausnahme, wenn ein Fehler auftritt.
    </para>

    <example id="zend.pdf.create.example-1">
        <title>Erstellen und Laden von PDF Dokumenten</title>

        <programlisting language="php"><![CDATA[
...
// Erstelle ein neues PDF Dokument
$pdf1 = new Zend_Pdf();

// Lade ein PDF Dokument aus einer Datei
$pdf2 = Zend_Pdf::load($fileName);

// Lade ein PDF Dokument aus einer Zeichenkette
$pdf3 = Zend_Pdf::parse($pdfString);
...
]]></programlisting>
    </example>

    <para>
        Das <acronym>PDF</acronym> Datei Format unterstützt die schrittweise Aktualisierung von
        Dokumenten. Jedes Mal, wenn ein Dokument aktualisiert wird, wird eine neue Revision des
        Dokuments erstellt. Die <classname>Zend_Pdf</classname> Komponente unterstützt die Rückgabe
        einer vorgegebenen Revision des Dokuments.
    </para>

    <para>
        Die Revision kann den Methoden <methodname>Zend_Pdf::load()</methodname> und
        <methodname>Zend_Pdf::parse()</methodname> als zweiter Parameter übergeben oder durch Aufruf
        der <methodname>Zend_Pdf::rollback()</methodname> Methode.

        <footnote>
            <para>
                Die <methodname>Zend_Pdf::rollback()</methodname> Methode muss vor einer Änderung
                eines Dokuments aufgerufen werden, andernfalls ist das Verhalten nicht definiert.
            </para>
        </footnote>

        Aufruf angefordert werden.
    </para>

    <example id="zend.pdf.create.example-2">
        <title>Rückgabe einer vorgegebenen Revision eines PDF Dokuments</title>

        <programlisting language="php"><![CDATA[
...
// Lade die vorherige Revision des PDF Dokuments
$pdf1 = Zend_Pdf::load($fileName, 1);

// Lade die vorherige Revision des PDF Dokuments
$pdf2 = Zend_Pdf::parse($pdfString, 1);

// Lade die erste Revision des PDF Dokuments
$pdf3 = Zend_Pdf::load($fileName);
$revisions = $pdf3->revisions();
$pdf3->rollback($revisions - 1);
...
]]></programlisting>
    </example>
</sect1>