PDFium Delphi Component Docs

FormFieldCount الخاصية

Component: TPdf  ·  Unit: PDFium
عدد عناصر واجهة حقل النموذج على الصفحة النشطة حاليًا

Syntax

property FormFieldCount: Integer; // read only

Description

تُرجع الخاصية FormFieldCount عدد تعليقات أدوات حقول AcroForm على الصفحة النشطة حاليًا. ويقابل كل مدخل تعليق أداة واحدًا (النوع الفرعي /Widget مع نوع حقل /FT) — إدخال نص، أو مربع اختيار، أو زر اختيار، أو صندوق قائمة، أو صندوق مركب، أو زر ضغط، أو حقل توقيع (القسم 12.7 من مواصفة PDF 1.7).

تكون القيمة 0 عندما تكون Active تساوي False، أو عندما لا يكون المستند من نوع AcroForm (FormType = ftNone)، أو عندما تخلو الصفحة من أي أدوات تفاعلية. وهي مقياس لكل صفحة؛ فقد تحتوي الصفحات على أدوات تنتمي إلى الحقل المنطقي نفسه المعرّف في موضع آخر من شجرة المستند — إذ يسمح PDF للحقل الواحد بأن له مواضع أدوات متعددة (مثل توقيع مرئي على الغلاف والصفحة الأخيرة).

استخدم FormFieldInfo[Index] بفهارس من 0 إلى FormFieldCount - 1 للحصول على سجل TPdfFormFieldInfo: نوع الحقل والاسم والاسم البديل والأعلام وتسميات الخيارات والقيمة الحالية وقيمة التصدير وحالة التحديد وحجم الخط. وللحصول على حقل عبر اختبار إصابة إحداثية صفحة استخدم FormFieldAt[X, Y] أو FormFieldInfoAt[X, Y] بدلًا من ذلك.

Remarks

Example

var I: Integer;
var Info: TPdfFormFieldInfo;
for I := 0 to Pdf1.FormFieldCount - 1 do
begin
  Info := Pdf1.FormFieldInfo[I];
  Memo1.Lines.Add(Format('%s = %s', [Info.Name, Info.ExportValue]));
end;

See Also

FormField, FormFieldInfo, FormType, HasFormFieldAt