PDFium Delphi Component Docs

Callbacks של מארח הטפסים

Component: TPdf  ·  Unit: 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 של המסמך יכול לבקש עמוד שאף תצוגה עדיין לא פתחה, ולכן מארח הטפסים טוען אותו בטעינה עצלה, שומר handle אחד לכל עמוד מבוקש, שולח התראות פתיחת עמוד מקוריות ומשחרר כל handle לפני סגירת סביבת הטפסים

FormHostCallbacksComplete הוא true לאחר שסביבת הטפסים התקינה את כל ה-callbacks הנדרשים מגרסה 1

Navigation and URI actions

OnFormGoToAction מקבל מספר עמוד שמתחיל מ-1, את מצב הזום המקורי ועותק חסום של מערך מיקום היעד

כאשר GoTo נשאר ללא טיפול, עמוד התצוגה שיזמה את אינטראקציית הטפסים משתנה, עם מעבר ל-TPdf.PageNumber בשימוש ללא ממשק; המארח יכול להגדיר Handled ולבצע בעצמו את הגלילה או הזום ליעד

OnFormUriAction מקבל ערכי URI מפוענחים וגולמיים וכן מקשי ההחזקה של המקלדת עבור פעולות AcroForm ו-XFA כאחד, ואינו מבצע הפעלה חיצונית אלא אם המארח בוחר לעשות זאת

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