repo_zf1/documentation/manual/he/module_specs/Zend_Pdf-Create.xml

<sect1 id="zend.pdf.create">
    <title>יצירת וטעינת קבצי PDF</title>
    <para>
        מחלקת ה <code>Zend_Pdf</code> מייצגת את מסמכי ה PDF ומספקת פעולת אשר קשורות למסמכים.
    </para>

    <para>
        כדי ליצור מסמך חדש, יש ליצור קודם כל אובייקט <code>Zend_Pdf</code> חדש.
    </para>

    <para>
        <code>Zend_Pdf</code> גם מספקת שני מתודות סטטיות לטעינה של קובץ PDF קיים.
        אלו הם המתודות <code>Zend_Pdf::load()</code> ו <code>Zend_Pdf::parse()</code>.
        שניהם מחזירות אובייקט <code>Zend_Pdf</code> כתוצאה או זורקות שגיאת חריג במידה וישנה שגיאה.
    </para>

    <example id="zend.pdf.create.example-1">
        <title>יצירת קובץ PDF חדש או טעינה של אחד קיים</title>
        <programlisting role="php"><![CDATA[
...
// Create a new PDF document
$pdf1 = new Zend_Pdf();

// Load a PDF document from a file
$pdf2 = Zend_Pdf::load($fileName);

// Load a PDF document from a string
$pdf3 = Zend_Pdf::parse($pdfString);
...
]]>
        </programlisting>
    </example>

    <para>
        קבצי ה PDF תומכים בעדכוני מסמכים. לכן בכל פעם שמסמך מעודכן גרסא חדשה שלו נוצרת.
        <code>Zend_Pdf</code> מאפשר קבלת המסמך בגרסא מסויימת שלו.
    </para>
    <para>
        ניתן להגדיר את הגרסא כפרמטר שני במתודות <code>Zend_Pdf::load()</code> ו <code>Zend_Pdf::parse()</code> או על ידי קריאה למתודה <code>Zend_Pdf::rollback()</code>.
        <footnote>
            <para>
                <code>Zend_Pdf::rollback()</code> חייבת להקרא לפני כל שינוי שנעשה במסמך, אחרת צורת ההתנהגות של המתודה לא מוגדרת.
            </para>
        </footnote>
    call.
    </para>

    <example id="zend.pdf.create.example-2">
        <title>קבלת גרסא מסויימת של קובץ PDF</title>
        <programlisting role="php"><![CDATA[
...
// Load the previous revision of the PDF document
$pdf1 = Zend_Pdf::load($fileName, 1);

// Load the previous revision of the PDF document
$pdf2 = Zend_Pdf::parse($pdfString, 1);

// Load the first revision of the PDF document
$pdf3 = Zend_Pdf::load($fileName);
$revisions = $pdf3->revisions();
$pdf3->rollback($revisions - 1);
...
]]>
        </programlisting>
    </example>


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