PDFium Delphi Component Docs

מתודת SetFocusableAnnotationSubtypes

Component: TPdf  ·  Unit: PDFium
מחליף את רשימת תתי-הסוגים של ההערות שסביבת מילוי הטפסים מתייחסת אליהם כניתנים למיקוד במהלך אינטראקציית מקלדת

Syntax

procedure SetFocusableAnnotationSubtypes(const Subtypes: array of TPdfAnnotationSubtype);

Subtypesמערך פתוח של TPdfAnnotationSubtype. הרשימה המחליפה המלאה; הערות מכל תת-סוג שאינו במערך אינן יכולות לקבל מיקוד. מערך ריק מנקה את הרשימה.

Description

סביבת מילוי הטפסים מחזיקה רשימה של תתי-סוגים של הערות הזכאים למיקוד. כברירת מחדל הרשימה כוללת את ה-widgets של הטפסים, שהם היעד של ניווט המקלדת ש-FocusFormField עובר בו. קריאה זו מחליפה את כל הרשימה דרך הממשק ה-native (FPDFAnnot_SetFocusableSubtypes), למשל כדי לאפשר ל-viewer לתת מיקוד גם להערות free-text או סימון אחרות

כל ערך TPdfAnnotationSubtype מקודד לערך ה-native שלו לפני הקריאה. העברת מערך ריק מעבירה מצביע nil עם ספירה אפס ומנקה את הרשימה, כך שאין דבר הניתן למיקוד עד שרשימה חדשה נקבעת

הקריאה דורשת מסמך טעון וסביבת מילוי טפסים מאותחלת; כאשר הטפסים אינם מאותחלים היא מעלה EPdfError עם ההודעה Form fill environment is not initialized. קריאת native שנכשלת מעלה את Cannot set focusable annotation subtypes. קראו את הרשימה הנוכחית בחזרה באמצעות GetFocusableAnnotationSubtypes

Remarks

Example

begin
  Pdf1.LoadFromFile('form.pdf');
  // widgets stay focusable, free-text notes join them
  Pdf1.SetFocusableAnnotationSubtypes([anWidget, anFreeText]);
end;

See Also

GetFocusableAnnotationSubtypes, FocusFormField, SetFormFieldFlags, FormField