GetFormFieldPageRect
حقول النماذج، تفاعل العارض
الوصف
تُرجع صفحة عنصر تحكم حقل نموذج واحد ومستطيله ضمن فضاء المستخدم للصفحة بترتيب من الأعلى إلى الأسفل، وهو الفضاء ذاته الذي تعتمد عليه المحررات الموضعية والطبقات التراكبية في العارض
يُستمد المستطيل من GetFormFieldBound بعد تسويته وفق إعداد GetOrigin الحالي للمكتبة، بحيث تتطابق القيمة مع فضاء الإحداثيات المستخدم في PageRectToClientRect وتظليل نتائج البحث، بصرف النظر عن اصطلاح نقطة الأصل الذي يختاره التطبيق
الصيغة
Delphi
Function TPDFlibViewer.GetFormFieldPageRect(FieldIndex: Integer; Out APage: Integer; Out XPt, YPt, WPt, HPt: Double): Boolean;المعاملات
| FieldIndex | فهرس حقل النموذج يبدأ من 1، وفق ما تُرجعه GetFormFieldCount |
|---|---|
| APage | تستقبل رقم الصفحة (ابتداءً من 1) التي يوجد عليها عنصر التحكم |
| XPt, YPt | تستقبلان إحداثيات بداية عنصر التحكم بوحدة نقاط فضاء صفحة المستخدم بترتيب من الأعلى إلى الأسفل |
| WPt, HPt | تستقبلان أبعاد عنصر التحكم (العرض والارتفاع) بوحدة نقاط فضاء صفحة المستخدم |
القيم المُرجعة
| True | تم إرجاع الصفحة والمستطيل |
|---|---|
| False | لا توجد مكتبة مرتبطة، أو الفهرس لا يشير إلى حقل نموذج، أو لا صفحة لهذا الحقل في المستند المحمَّل؛ وتكون جميع المخرجات صفرًا |
انظر أيضًا
FormFieldAtPagePoint, ToggleCheckBoxField, GetFormFieldTabSequence, GetFormFieldEditorKind, PageRectToClientRect