PDFium Delphi Component Docs

ImportXFDF الطريقة

المكوّن: TPdf  ·  الوحدة: PDFium
تقرأ مستند XFDF (ISO 19444-1) وتطبِّق قيم حقول النموذج والتعليقات الخاصة به على PDF المحمَّل، منشئةً تعليقات على الصفحات المطابقة وكاتبةً قيم الحقول في تعليقات أدواتها.

الصياغة

function ImportXFDF(const FileName: string): Integer; overload;
function ImportXFDF(Stream: TStream): Integer; overload;

الوصف

يحلل ImportXFDF مستند XFDF XML ويطبِّق قسميه <fields> و <annots> على PDF المحمَّل حاليًا.

For each <field> element, the qualified (dotted) name is matched against the widget annotations in the document and the value is written into the field's /V entry. For checkbox and radio-button fields, the supplied export value is used to select the matching on-state appearance, so the field is rendered as checked.

يمسح <value> الفارغ صراحةً الحقل المطابق، بينما تتركه القيمة المهملة دون تغيير؛ وتحتفظ أسماء الحقول المنقَّطة شديدة التداخل بتسلسلها الهرمي الكامل

لكل عنصر تعليق، يُنشأ تعليق جديد على الصفحة التي تشير إليها سمة page (صفرية الأساس). بعد الإنشاء، يملأ المستورد Contents و Author (العنوان) و Name (NM) و Subject و ModificationDate و CreationDate و Icon وعلامات التعليق من سمات XFDF المقابلة.

يعيد العدد الإجمالي للحقول والتعليقات المعالجة.

يطبِّق استيراد التعليقات ألوان RGB والداخلية، ويحافظ على حقول النص الفارغة الصريحة، ويحلل الإحداثيات العشرية مستقلًا عن لغة العملية المحلية، ويستعيد كل رباعي تمييز من سمة coords

يقبل الماسح عناصر وسمات مسبوقة بفضاء أسماء، وعقد نص و CDATA مختلطة، ومراجع كيانات XML، ومحتوى حقل أو تعليق مهم المسافات؛ وترفض مراجع أحرف Unicode العددية غير الصالحة إدخال XFDF

An omitted annotation contents element leaves the new annotation's content absent, while an explicit empty element writes an empty value

سمة rect إلزامية لكل تعليق: إذا كانت مفقودة، يُتخطى التعليق بدلًا من إنشائه بمستطيل بحجم صفر.

Parsing is performed by a hand-written XML scanner rather than a full XML DOM, so ImportXFDF introduces no XML DOM dependency.

ملاحظات

مثال

// Import field values and annotations from an .xfdf file
Imported := Pdf1.ImportXFDF('C:\Data\form.xfdf');
Pdf1.SaveAs('C:\Data\form_filled.pdf');

انظر أيضًا

ExportXFDF, CreateAnnotation, Annotation, FormFieldInfo