FormFieldInfo - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

سجل كامل يصف حقل نموذج عند فهرس معطى على الصفحة النشطة

Syntax

property FormFieldInfo[Index: Integer]: TPdfFormFieldInfo; // read only

Description

تُرجع الخاصية FormFieldInfo سجل TPdfFormFieldInfo لقطةً لحقل النموذج عند التعليق ذي الفهرس الذي يبدأ من الصفر Index على الصفحة النشطة حاليًا. ويوفر السجل عرضًا مكتوب الأنواع لأداة حقل AcroForm واحدة من دون الحاجة إلى تفكيك مقبض FPDF_ANNOTATION الأساسي. ويعرّف القسم 12.7 من مواصفة PDF 1.7 أنواع الحقول وأعلامها الأساسية.

يحمل السجل Name للحقل (المسار المؤهل بالكامل عبر أي مجموعة حقول أب، مثل "order.shipto.address")، و AlternateName المستخدم للتلميحات الملائمة للإتاحة، و تعداد FieldType (fiPushButton و fiCheckBox و fiRadioButton و fiTextField و fiListBox و fiComboBox و fiSignature أو fiUnknown)، و Flags مجموعة البتات (ffReadOnly و ffRequired و ffNoExport و …)، و ExportValue كما يُكتب في تصدير FormData، وعلم Checked للحقول المنطقية، و FontSize المستخدم للعرض، ومصفوفتي مجموعة الخيارات OptionLabels / OptionSelected اللتين تستخدمهما صندوقا combo و list. وتملأ أدوات أزرار الاختيار التابعة لمجموعة أيضًا GroupCount و GroupIndex.

الفهارس الصالحة هي 0 .. FormFieldCount - 1. والسجل نوع قيمي؛ فتعديل حقوله لا يكتب обратно إلى المستند. ولتغيير قيمة حقل أسند عبر FormField[Index]؛ ولتغيير قناع الأعلام استدعِ SetFormFieldFlagsAt. والقراءة بكسلة — إذ يفك PDFium أسماء الحقول Unicode وتسميات الخيارات وقيم التصدير عند الطلب — لذا خزّن النتيجة مؤقتًا عندما تستعرض حقولًا كثيرة عدة مرات.

Parameters

Index فهرس أداة يبدأ من الصفر على الصفحة الحالية (0 .. FormFieldCount - 1).

Remarks

مجموعة الحقول مرتبطة بالصفحة — فالحقل نفسه له فهرس مختلف على كل صفحة تستضيف أداة له. استخدم Name لإزالة التكرار عبر الصفحات.
حقول التوقيع (fiSignature) تكشف Name والمستطيل من دون بايتات التوقيع؛ استخدم Signature[I] على مستوى المستند للحصول على محتوى PKCS#7.
في مجموعات أزرار الاختيار قد ينتج المجموعة نفسها عدة سجلات على صفحة واحدة (واحد لكل زر)؛ قارن GroupCount / GroupIndex لتمييزها.
إذا كان المستند بلا قاموس AcroForm فستكون FormFieldCount تساوي 0 ولن يكون هذا المفهرس قابلًا للاستدعاء إطلاقًا.

Example

var I, J: Integer;
var Info: TPdfFormFieldInfo;
for I := 0 to Pdf1.FormFieldCount - 1 do
begin
  Info := Pdf1.FormFieldInfo[I];
  Memo1.Lines.Add(Format('%s [%d] export=%s checked=%s',
    [Info.Name, Ord(Info.FieldType), Info.ExportValue, BoolToStr(Info.Checked, True)]));
  for J := 0 to High(Info.OptionLabels) do
    Memo1.Lines.Add(' ' + Info.OptionLabels[J]);
end;

FormFieldInfo الخاصية