PDFium Delphi Component Docs

کال‌بک‌های میزبان فرم

کامپوننت: TPdf  ·  واحد: PDFium
اتصال تعامل فرم PDFium به رفتار پیمایش، URI، نشانگر ماوس، تغییر، صفحه و انتخاب در میزبان

Properties and events

property FormHostCallbacksComplete: Boolean; // read only

property FormSelectionRects: TPdfFormSelectionRects; // read only

procedure ClearFormSelectionRects;

property OnFormCursor: TPdfFormCursorEvent;

property OnFormValueChange: TPdfFormValueChangeEvent;

property OnFormUriAction: TPdfFormUriActionEvent;

property OnFormGoToAction: TPdfFormGoToActionEvent;

property OnFormSelectionRect: TPdfFormSelectionRectEvent;

Page ownership

JavaScript سند می‌تواند صفحه‌ای را درخواست کند که هنوز هیچ نمایی بازش نکرده؛ بنابراین میزبان فرم آن را با تأخیر بار می‌کند، به‌ازای هر صفحهٔ درخواستی یک دسته نگه می‌دارد، اعلان‌های نیتیو باز شدن صفحه را می‌فرستد و همهٔ دسته‌ها را پیش از بسته شدن محیط فرم آزاد می‌کند

FormHostCallbacksComplete پس از آنکه محیط فرم همهٔ کال‌بک‌های لازم نسخهٔ ۱ را نصب کرده باشد true است

Navigation and URI actions

OnFormGoToAction یک شمارهٔ صفحه با شماره‌گذاری یک-مبنا، حالت زوم نیتیو و یک کپی کراندار از آرایهٔ موقعیت مقصد دریافت می‌کند

بی‌توجه گذاشتن GoTo صفحهٔ نمایی را عوض می‌کند که تعامل فرم را آغاز کرده؛ در کاربرد بدون-رابط به TPdf.PageNumber برمی‌گردد. میزبان می‌تواند Handled را ست کند و اسکرول یا زوم مقصد را خودش اعمال کند

OnFormUriAction برای اکشن‌های AcroForm و XFA، مقادیر URI رمزگشایی‌شده و خام را همراه کلیدهای اصلاح‌کنندهٔ کیبورد می‌گیرد و مگر میزبان خودش بخواهد، هیچ اجرای بیرونی انجام نمی‌دهد

Cursor, changes, and selected rectangles

OnFormCursor هم یک مقدار پایدار TPdfFormCursor و هم کد نیتیو اصلی نشانگر را دریافت می‌کند؛ مقدار پایدار یکی از pfcUnknown، pfcArrow، pfcSizeNESW، pfcSizeNWSE، pfcVerticalBeam، pfcHorizontalBeam یا pfcHand است و بی‌توجه گذاشتنش فقط نمایی را به‌روز می‌کند که تعامل فرم را آغاز کرده

OnFormValueChange پس از باطل‌کردن کش‌های صفحهٔ مشتق‌شده اجرا می‌شود و اعلان‌های تغییر تودرتو را یکی می‌کند

FormSelectionRects یک اسنپ‌شات متعلق به فراخوان با حداکثر 4096 مستطیل فضای صفحه از انتخاب متن فرم نیتیو برمی‌گرداند؛ OnFormSelectionRect هر مستطیل تازه را جریانی می‌فرستد و ClearFormSelectionRects هندسهٔ نگه‌داشته‌شده را خالی می‌کند

See Also

FormFieldInfo, FormFieldTypeAtPoint, TPdfView.FormFieldInfoAt