documentation/manual/pl/module_specs/Zend_Pdf-Pages.xml

   1 <sect1 id="zend.pdf.pages">
   2     <title>Strony dokumentu.</title>
   3     <sect2 id="zend.pdf.pages.creation">
   4         <title>Tworzenie strony.</title>
   5         <para>
   6             Strona dokumentu PDF jest reprezentowana przez klasę <code>Zend_Pdf_Page</code>.
   7         </para>
   8
   9         <para>
  10             Strony PDF mogą być tworzone lub ładowane z istniejącego dokumentu PDF.
  11         </para>
  12
  13         <para>
  14             Nowa strona może być dodana przez utworzenie obiektu <code>Zend_Pdf_Page</code>
  15             lub wywołanie metody <code>Zend_Pdf::newPage()</code>, która zwraca obiekt <code>Zend_Pdf_Page</code>.
  16             Różnicą jest to, że metoda <code>Zend_Pdf::newPage()</code> tworzy stronę dołączoną
  17             do dokumentu. W przeciwieństwie to luźnych stron, niepołączonych z żadnym dokumentem,
  18             nie może ona być użyta z kilkoma dokumentami PDF, ale ma ona trochę lepszą wydajność.
  19             <footnote>
  20                 <para>
  21                 Jest to limitacja wersji V1.0 modułu Zend_Pdf. Będzie to wyeliminowane
  22                 w przyszłych wersjach. Jednak luźne strony zawsze będą dawały lepsze
  23                 (bardziej optymalne) wyniki przy używaniu stron w kilku dokumentach.
  24                 </para>
  25             </footnote>. Do ciebie należy wybor sposobu, którego użyjesz.
  26         </para>
  27
  28         <para>
  29         Metoda <code>Zend_Pdf::newPage()</code> oraz konstruktor klasy <code>Zend_Pdf_Page</code>
  30         przyjmują ten sam zestaw parametrów. W obydwóch jest to rozmiar strony ($x, $y)
  31         w punktach (1/72 cala), lub definiowana stała, która jest traktowana jako typ
  32         strony:
  33             <itemizedlist>
  34                 <listitem>
  35                     <para>Zend_Pdf_Page::SIZE_A4</para>
  36                 </listitem>
  37                 <listitem>
  38                     <para>Zend_Pdf_Page::SIZE_A4_LANDSCAPE</para>
  39                 </listitem>
  40                 <listitem>
  41                     <para>Zend_Pdf_Page::SIZE_LETTER</para>
  42                 </listitem>
  43                 <listitem>
  44                     <para>Zend_Pdf_Page::SIZE_LETTER_LANDSCAPE</para>
  45                 </listitem>
  46             </itemizedlist>
  47         </para>
  48
  49         <para>
  50             Strony dokumentu są przechowywane w tablicy <code>$pages</code> będącej
  51             publiczną właściwością klasy <code>Zend_Pdf</code>. Jest to tablica obiektów
  52             <code>Zend_Pdf_Page</code>. Kompletnie definiuje ona zbiór oraz kolejność
  53             stron dokumentu, a także możemy nią manipulować jak zwykłą tablicą:
  54         </para>
  55
  56         <example id="zend.pdf.pages.example-1">
  57             <title>Zarządzanie stronami dokumentu PDF.</title>
  58             <programlisting role="php"><![CDATA[
  59 ...
  60 // Odwróć kolejność stron
  61 $pdf->pages = array_reverse($pdf->pages);
  62 ...
  63 // Dodaj nową stronę
  64 $pdf->pages[] = new Zend_Pdf_Page(Zend_Pdf_Page::SIZE_A4);
  65 // Dodaj nową stronę
  66 $pdf->pages[] = $pdf->newPage(Zend_Pdf_Page::SIZE_A4);
  67
  68 // Usuń określoną stronę.
  69 unset($pdf->pages[$id]);
  70
  71 ...
  72 ]]>
  73             </programlisting>
  74         </example>
  75     </sect2>
  76
  77     <sect2 id="zend.pdf.pages.cloning">
  78         <title>Klonowanie stron.</title>
  79         <para>
  80             Istniejące strony PDF mogą być klonowane przez tworzenie nowego
  81             obiektu <code>Zend_Pdf_Page</code> z istniejącą stroną w parametrze.
  82         </para>
  83
  84         <example id="zend.pdf.pages.example-2">
  85             <title>Klonowanie istniejącej strony.</title>
  86             <programlisting role="php"><![CDATA[
  87 ...
  88 // Przechowaj szablon strony w osobnej zmiennej
  89 $template = $pdf->pages[$templatePageIndex];
  90 ...
  91 // Dodaj nową stronę
  92 $page1 = new Zend_Pdf_Page($template);
  93 $pdf->pages[] = $page1;
  94 ...
  95
  96 // Dodaj kolejną stronę
  97 $page2 = new Zend_Pdf_Page($template);
  98 $pdf->pages[] = $page2;
  99 ...
 100
 101 // Usuń źródłowy szablon strony z dokumentów
 102 unset($pdf->pages[$templatePageIndex]);
 103
 104 ...
 105 ]]>
 106             </programlisting>
 107         </example>
 108
 109         <para>
 110             Jest to przydatne gdy chcesz utworzyć wiele stron używając jednego
 111             szablonu.
 112         </para>
 113
 114         <caution>
 115             <para>
 116                 Ważne! Klonowane strony korzystają z tych samych zasobów co
 117                 szablon strony, więc mogą być one użyte tylko w tym samym
 118                 dokumencie co szablon. Zmodyfkowany dokument może być zapisany
 119                 jako nowy dokument.
 120             </para>
 121         </caution>
 122     </sect2>
 123 </sect1>