PDFium Delphi Component Docs

FormFieldAt الخاصية

Component: TPdf  ·  Unit: PDFium
اقرأ أو اكتب قيمة حقل النموذج الموجود عند إحداثي الصفحة المعطى

Syntax

property FormFieldAt[X, Y: Single]: WString; // read / write

Description

تبحث الخاصية FormFieldAt عن تعليق أداة AcroForm الذي يحتوي نقطة فضاء الصفحة (X, Y) وتكشف قيمته على هيئة نص Unicode. والإحداثيات في فضاء مستخدم PDF، بأصل عند الركن السفلي الأيسر للصفحة ووحداتها نقاط (1/72 بوصة). وتُرجع قراءة الخاصية قيمة الحقل الحالية (/V) مفكوكة الترميز إلى WString؛ بينما يحدّث الإسناد الحقل ويعيد توليد مسارات المظهر كي يُعرض القيمة الجديدة في الرسم التالي.

تُرجع نصًا فارغًا عندما تكون Active تساوي False، أو عندما لا يحوي المستند AcroForm، أو عندما لا تغطي أي أداة الإحداثية. وتطابق سياسة المطابقة FormFieldInfoAt: مستطيلات الأدوات فقط (من دون اختبار إصابة مرتبط بالمظهر)، والأداة العليا هي الفائزة عند التراكب. وتصبح الكتابات بلا أثر عندما تفوت الإحداثية كل أداة.

في أدوات مربعات الاختيار وأزرار الاختيار تتبع دلالات القيمة مواصفة PDF — فإسناد 'Off' يفرّغ الحقل، وإسناد القيمة المطابقة لاسم حالة التشغيل في /AP /N الخاص بالأداة (وعادة 'Yes' أو قيمة التصدير) يضع علامة الاختيار. أما حقول النص فيصبح أي ما تسنده محتويات /V الجديدة. وتقبل قوائم List / combo قيمة التصدير المقترنة بأحد مدخلات الخيارات. استخدم FormFieldInfoAt أولًا لفحص FieldType إذا كان نوع الحقل غير مؤكد.

Remarks

Example

// Toggle a checkbox located at (120, 300) on the current page.
if Pdf1.FormFieldAt[120.0, 300.0] = 'Off' then
  Pdf1.FormFieldAt[120.0, 300.0] := 'Yes'
else
  Pdf1.FormFieldAt[120.0, 300.0] := 'Off';

See Also

FormFieldInfoAt, HasFormFieldAt, FormField, FormFieldCount