THotPDF.SetLoadedFreeTextText Method

מחליף את ה-appearance הרגיל של הערת FreeText במסמך שנטען באמצעות גופני Unicode מוטמעים, טקסט עשיר אופציונלי וטרנזקציית גרף אטומית

הצהרה

procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
  const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
  const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');

אפשרויות

אתחלו את הרקורד עם THPDFLoadedTextAppearanceOptions.Default לפני שינוי שדות בודדים

שדההתנהגות
FontName, FontStyle, FontSizeגופן ראשי, סגנון וגודל בנקודות; ברירות המחדל הן Arial, regular ו-12 נקודות
TextColor, Alignment, Paddingצבע טקסט פשוט, יישור לשמאל/מרכז/ימין וריפוד בנקודות; ברירות המחדל הן שחור, שמאל ו-2 נקודות
Opacity, Rotationאטימות בטווח [0,1] וסיבוב בכפולות של 90 מעלות
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ‏ltopReject דוחה גלישה, ‏ltopClip חותך אותה, ו-ltopShrinkToFit מנסה שוב עם גופנים קטנים יותר
MinFontSizeחסם תחתון לכיווץ, ברירת מחדל 4 נקודות
MaxTextUnitsתקציב קלט וטקסט פשוט, ברירת מחדל 1,048,576 יחידות UTF-16; קלט עשיר מוגבל לארבע פעמים התקציב הזה

התנהגות

AText מספק טקסט Unicode פשוט; ‏RichContent לא ריק ב-UTF-8 משתמש במקום זאת במייבא ה-HTML וב-CSS אופציונלי של DefaultStyle, ואז נגזר /Contents מהטקסט שנוצר

ה-appearance שנוצר מעתיק גופנים מוטמעים ומיפויי ToUnicode אל המסמך שנטען, כך ששמירה, שיטוח וחילוץ טקסט משמרים את הטקסט שלו ב-Unicode

השיטה יורשת את שרשראות ה-fallback של הגופנים המוגדרות, את ShapingFeatures, את מתגי ה-auto-shaping של ערבית, סורית, N'Ko, Adlam ו-Hanifi Rohingya, ואת בחירות ה-script והשפה של ה-GSUB; כל ניסיון shrink-to-fit חוזר משתמש באותן הגדרות בלי לשנות את התצורה של קוד הקריאה

השיטה משמרת רקע נתמך, מסגרת מלאה/מקווקוות, insets של מלבן וגיאומטריית callout של שתיים/שלוש נקודות, ומסנכרנת את /AP, /Contents, /RC, /DS, /CA, /Q ואת מטא-נתוני הסיבוב

גיאומטריה לא חוקית, גליפי טקסט פשוט שלא נפתרו, מסגרות cloudy, מגבלות משאב וגלישה שנדחתה מעלים חריגה ומבצעים rollback לעדכון כולו; טרנזקציות גרף חיצוניות קיימות נשארות פעילות

טקסט עשיר כפוף לתת-הקבוצה הנתמכת של HTML/CSS; משאבים חיצוניים מנוטרלים, וגדלי גופן CSS קבועים עשויים למנוע מ-shrink-to-fit להקטין ריצות בודדות

כל כותב appearance מקבל עד 256 בחירות גופן עיצוב נבדלות ועד 64 MiB של נתוני גופן גולמיים מצטברים; חריגה מאחת מהמגבלות דוחה את העדכון ומשמרת את ההערה המקורית

ממשקי API קשורים