repo_zf1/documentation/manual/de/module_specs/Zend_Pdf-Pages.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15157 -->
<!-- Reviewed: no -->
<sect1 id="zend.pdf.pages">
    <title>Arbeiten mit Seiten</title>
    <sect2 id="zend.pdf.pages.creation">
        <title>Erstellen von Seiten</title>
        <para>
            Die Seiten in einem PDF Dokument werden durch <classname>Zend_Pdf_Page</classname> Instanzen in
            <classname>Zend_Pdf</classname> abgebildet.
        </para>

        <para>
            PDF Seiten werden entweder aus einem vorhandenen PDF gelesen oder erstellt indem die API von
            <classname>Zend_Pdf</classname> verwendet wird.
        </para>

        <para>
            Neue Seiten können durch die Instanzierung neuer <classname>Zend_Pdf_Page</classname> Objekte erstellt
            werden, entweder direkt oder durch den Aufruf der <classname>Zend_Pdf::newPage()</classname> Methode,
            die ein <classname>Zend_Pdf_Page</classname> Objekt zurückgibt. <classname>Zend_Pdf::newPage()</classname> erstellt
            eine Seite die bereits an ein Dokument angehängt ist. Ungebundene Seiten können nicht mit
            verschiedenen PDF Dokumenten verwendet werden, sind aber etwas schneller.
            <footnote>
                <para>
                Dies ist eine Einschränkung der aktuellen ZF Version. Sie wird in
                zukünftigen Versionen beseitigt werden. Aber ungebundene Seiten werden immer ein
                besseres (also optimaleres) Ergebnis für gemeinsame Benutzung in Dokumenten liefern.
                </para>
            </footnote>
        </para>

        <para>
            Die <classname>Zend_Pdf::newPage()</classname> Methode und der <classname>Zend_Pdf_Page</classname> Konstruktor
            benötigen die gleichen Parameter welche die Größe der Seite spezifizieren. Sie können entweder
            die Seitengröße ($x, $y) in Punkten (1/72 Zoll) nehmen oder eine vordefinierte Konstante, die den
            Seitentyp repräsentiert:
            <itemizedlist>
                <listitem>
                    <para>Zend_Pdf_Page::SIZE_A4</para>
                </listitem>
                <listitem>
                    <para>Zend_Pdf_Page::SIZE_A4_LANDSCAPE</para>
                </listitem>
                <listitem>
                    <para>Zend_Pdf_Page::SIZE_LETTER</para>
                </listitem>
                <listitem>
                    <para>Zend_Pdf_Page::SIZE_LETTER_LANDSCAPE</para>
                </listitem>
            </itemizedlist>
        </para>

        <para>
            Dokumentseiten werden im öffentlichen <code>$pages</code> Attribut der <classname>Zend_Pdf</classname>
            Klasse abgelegt. Das Attribut enthält ein Array mit <classname>Zend_Pdf_Page</classname>
            Objekten und definiert die komplette Instanz und die Reihenfolge der Seiten. Dieses Array kann
            wie ein normales Array verändert werden:
        </para>

        <example id="zend.pdf.pages.example-1">
            <title>Verwaltung von PDF Dokumentseiten</title>
            <programlisting role="php"><![CDATA[
...
// Umgekehrte Seitenreihenfolge
$pdf->pages = array_reverse($pdf->pages);
...
// Füge eine neue Seite hinzu
$pdf->pages[] = new Zend_Pdf_Page(Zend_Pdf_Page::SIZE_A4);
// Füge eine neue Seite hinzu
$pdf->pages[] = $pdf->newPage(Zend_Pdf_Page::SIZE_A4);

// Entferne eine bestimmte Seite
unset($pdf->pages[$id]);

...
]]></programlisting>
        </example>
    </sect2>

    <sect2 id="zend.pdf.pages.cloning">
        <title>Klonen von Seiten</title>
        <para>
            Bestehende PDF Seiten können durch das Erstellen eines neuen <classname>Zend_Pdf_Page</classname> Objektes
            geklont werden indem eine existierende Seite als Parameter angegeben wird:
        </para>

        <example id="zend.pdf.pages.example-2">
            <title>Klonen bestehender Seiten</title>
            <programlisting role="php"><![CDATA[
...
// Die Template Seite in einer separaten Variable speichern
$template = $pdf->pages[$templatePageIndex];
...
// Neue Seite hinzufügen
$page1 = new Zend_Pdf_Page($template);
$pdf->pages[] = $page1;
...

// Andere Seite hinzufügen
$page2 = new Zend_Pdf_Page($template);
$pdf->pages[] = $page2;
...

// Die Quell Template Seite von den Dokumenten entfernen
unset($pdf->pages[$templatePageIndex]);

...
]]></programlisting>
        </example>

        <para>
            Das ist nützlich wenn verschiedene Seite mit Hilfe eines Templates erstellt werden sollen.
        </para>

        <caution>
            <para>
                Wichtig! Geklonte Seiten verwenden die gleichen PDF Ressourcen mit der Template Seite.
                Diese kann also nur innerhalb des gleichen Dokuments als Template Seite verwendet werden.
                Modifizierte Dokumente können als neue abgespeichert werden.
            </para>
        </caution>
    </sect2>

</sect1>
<!--
vim:se ts=4 sw=4 et:
-->