وثائق PDFiumPas

SaveAs الطريقة

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.
المكون: TPdf  ·  الوحدة: PDFium
يحفظ نسخة مستند PDF إلى الدفق المحدد. وإذا كانت PdfVersion بين pv13 و pv17، تُطبَّع النتيجة المحفوظة وتُتحقق لإصدار الهدف هذا، بما في ذلك تجاوزات /Version الموجودة في catalog ضمن الإخراج التزايدي. ويغطي المدقق خط ميزات PDF 1.1–1.7 / ISO 32000-1 بالكامل: المرشحات (FlateDecode و JBIG2Decode و JPXDecode)، وتدفقات object و xref، والشفافية (SMask و ca/CA و blend modes)، وTagged PDF (StructTreeRoot و MarkInfo)، وفضاءات الألوان (ICCBased و DeviceN)، وصناديق الصفحة (BleedBox/TrimBox/ArtBox)، وoutput intents، والمحتوى الاختياري، وAcroForm، وخطوط CID/Type 0 وOpenType، وتشفير AES و AES-256 (CFM AESV2/AESV3)، وجميع الأنواع الفرعية للتعليقات التوضيحية المقيّدة بالإصدار (Widget و Sound و Movie و FreeText و Line و Square و Circle و Highlight و Underline و StrikeOut و Stamp و Ink و Popup و FileAttachment و TrapNet و Squiggly و PrinterMark و Polygon و PolyLine و Caret و Screen و Watermark و 3D و Redact)، وأنواع الإجراءات المقيّدة بالإصدار (SubmitForm و ResetForm و ImportData و Hide و Named و JavaScript و Trans و SetState و Rendition و GoToE و GoTo3DView)، وإدخالات catalog (Perms و Legal و Collection و Requirements و NeedsRendering). وأي شيء يتجاوز إصدار الهدف المختار يرفع EPdfError. وإذا لم يكن للمستند OpenAction موجود وكان إصدار الهدف يدعمه، يفتح PDF المحفوظ على الصفحة الأولى مع تكبير Fit Height. وتطبق نسخ Trial علامة Trial المائية أثناء الحفظ

الصياغة

function SaveAs(Stream: TStream; Option: TSaveOption = saNone; PdfVersion: TPdfVersion = pvUnknown): Boolean;

StreamTStream. دفق TStream لكتابة بيانات PDF إليه
OptionTSaveOption. خيار الحفظ: soNone لإعادة كتابة كاملة، أو soIncremental لتحديث تزايدي يُلحق بالملف
PdfVersionTPdfVersion. إصدار PDF الهدف. استخدم pvUnknown للاحتفاظ بالإصدار الحالي

 

function SaveAs(const FileName: string; Option: TSaveOption = saNone; PdfVersion: TPdfVersion = pvUnknown): Boolean;

FileNamestring. مسار ملف الإخراج. يُنشأ الملف أو يُستبدل
OptionTSaveOption. خيار الحفظ: soNone لإعادة كتابة كاملة، أو soIncremental لتحديث تزايدي يُلحق بالملف
PdfVersionTPdfVersion. إصدار PDF الهدف. استخدم pvUnknown للاحتفاظ بالإصدار الحالي

قيمة الإرجاع

تُرجع True إذا حُفظ المستند بنجاح، أو False عند الفشل

الوصف

يحفظ المستند الحالي إلى مسار ملف أو TStream. ويتحكم المعامل Option في نمط الحفظ: ينفذ soNone إعادة كتابة كاملة للملف، بينما يلحق soIncremental التغييرات فقط التي أُجريت منذ آخر حفظ للمستند، وهو إخراج أصغر لكنه يكبر مع التكرار

يحدد المعامل PdfVersion إصدار PDF الناتج، ومرر pvUnknown للاحتفاظ بالإصدار الحالي للمستند

تتحكم الخاصية Compressed فيما إذا كان ضغط object-stream يُطبَّق أثناء الحفظ

مثال

// احفظ إلى ملف
Pdf.SaveAs('output.pdf');

// احفظ إلى دفق
var MS: TMemoryStream;
MS := TMemoryStream.Create;
try
  Pdf.SaveAs(MS);
  MS.SaveToFile('output.pdf');
finally
  MS.Free;
end;

انظر أيضا

LoadDocument, Compressed, CreateDocument