THotPDF.SetLoadedFreeTextText Method

ظاهر عادی یک حاشیه‌نویسی FreeText بارگذاری‌شده را با فونت‌های Unicode جاسازی‌شده، rich text اختیاری و یک graph transaction اتمیک جایگزین می‌کند

اعلان

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

گزینه‌ها

رکورد را پیش از تغییر فیلدهای منفرد با THPDFLoadedTextAppearanceOptions.Default مقداردهی اولیه کنید

فیلدرفتار
FontName, FontStyle, FontSizeقلم اصلی، style و اندازهٔ point؛ پیش‌فرض‌ها Arial، regular و 12 point است
TextColor, Alignment, Paddingرنگ متن ساده، تراز چپ/وسط/راست و padding بر حسب point؛ پیش‌فرض‌ها مشکی، چپ و 2 point است
Opacity, Rotationشفافیت در بازهٔ [0,1] و چرخش در مضرب 90 درجه
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ‏ltopReject سرریز را رد می‌کند، ltopClip آن را clip می‌کند و ltopShrinkToFit با قلم‌های کوچک‌تر دوباره تلاش می‌کند
MinFontSizeکران پایین کوچک‌سازی؛ پیش‌فرض 4 point
MaxTextUnitsبودجهٔ ورودی و متن ساده؛ پیش‌فرض 1,048,576 واحد UTF-16؛ ورودی rich به چهار برابر این بودجه محدود است

رفتار

AText متن سادهٔ Unicode می‌دهد؛ RichContent ‏UTF-8 غیرخالی به‌جایش از HTML importer و DefaultStyle اختیاری CSS استفاده می‌کند و سپس /Contents را از متن تولیدشده مشتق می‌کند

appearance تولیدشده فونت‌های جاسازی‌شده و نگاشت‌های ToUnicode را داخل سند بارگذاری‌شده کپی می‌کند، پس ذخیره، flatten و استخراج متن، متن Unicode آن را حفظ می‌کنند

این متد زنجیره‌های font fallback پیکربندی‌شده، ShapingFeatures، کلیدهای auto-shaping عربی، سریانی، N'Ko، Adlam و Hanifi Rohingya و انتخاب‌های script و زبان GSUB را به ارث می‌برد؛ هر تلاش مجدد shrink-to-fit بدون تغییر پیکربندی فراخوان از همان تنظیمات استفاده می‌کند

زمین پشتیبانی‌شده، حاشیهٔ solid/dashed، insetهای مستطیل و هندسهٔ callout دو/سه‌نقطه‌ای را حفظ می‌کند و /AP، /Contents، /RC، /DS، /CA، /Q و متادیتای چرخش را همگام می‌کند

هندسهٔ نامعتبر، گلیف‌های متن سادهٔ حل‌نشده، حاشیه‌های cloudy، محدودیت‌های منابع و سرریز ردشده استثنا پرتاب می‌کنند و کل به‌روزرسانی را rollback می‌کنند؛ graph transactionهای بیرونیِ موجود فعال می‌مانند

rich text از زیرمجموعهٔ پشتیبانی‌شدهٔ HTML/CSS پیروی می‌کند؛ منابع خارجی غیرفعال‌اند و اندازه‌های ثابت فونت CSS ممکن است جلوی کوچک‌شدن runهای منفرد توسط shrink-to-fit را بگیرند

هر appearance writer حداکثر 256 انتخاب فونت shaping متمایز و 64 MiB دادهٔ خام فونت تجمعی می‌پذیرد؛ گذر از هرکدام از این دو حد، به‌روزرسانی را رد و حاشیه‌نویسی اصلی را حفظ می‌کند

APIهای مرتبط