THotPDF.SetLoadedFreeTextPlainText Method

حاشیه‌نویسی FreeText بارگذاری‌شده و پشتیبانی‌شده را صراحتاً به متن ساده هم‌ترازِ چپ تبدیل می‌کند و ظاهر عادی آن را از نو می‌سازد

اعلان

procedure SetLoadedFreeTextPlainText(PageIndex, AnnotationIndex: Integer;
  const AText: AnsiString; FontSize: Single = 12);

واحد: HPDFDoc · از نسخهٔ 2.753.0 موجود است

پارامترها

• PageIndex: فهرست صفحهٔ بارگذاری‌شده با مبنای صفر
• AnnotationIndex: فهرست حاشیه‌نویسی با مبنای صفر در آن صفحه
• AText: نویسه‌های ASCII چاپ‌پذیر، با CR یا LF یا CR/LF برای شکست خط‌های صریح؛ تب‌ها، سایر نویسه‌های کنترلی و متن غیر ASCII رد می‌شوند
• FontSize: اندازهٔ متناهی بر حسب نقطهٔ PDF، بزرگ‌تر از صفر و حداکثر 10,000، با پیش‌فرض 12

تبدیل ظاهر

متد از متن Helvetica سیاه و قاب مستطیل سیاه استفاده می‌کند، پس‌زمینهٔ رنگ دستگاه پشتیبانی‌شده و هندسهٔ قاب پیوسته یا خط‌چین را حفظ می‌کند و متن را به تورفتگی دونقطه‌ای داخل مستطیل حاشیه‌نویسی برش می‌زند

خط‌ها 1.2 برابر اندازهٔ فونت پیش می‌روند؛ شکست خط خودکار یا کوچک‌سازی برای جا شدن وجود ندارد، بنابراین متن بیرون از تورفتگی بریده می‌شود

تبدیل /AP را جایگزین می‌کند، /Contents و /DA را به‌روزرسانی می‌کند، /Q را صفر می‌گذارد و /RC و /DS و /AS را حذف می‌کند؛ rich text قدیمی، انتخاب فونت، رنگ متن، تراز و وضعیت‌های ظاهر عمداً جایگزین می‌شوند

تغییرهای حاشیه‌نویسی، ظاهر و صفحه برای ذخیرهٔ افزایشی ثبت می‌شوند و حافظهٔ نهان رندر صفحه باطل می‌شود؛ ذخیرهٔ بازنویسی نیز ظاهر جدید را حفظ می‌کند

ورودی پشتیبانی‌شده و خطاها

حاشیه‌نویسی باید وجود داشته باشد و زیرنوع آن FreeText باشد، با مستطیل متناهی که عرض و ارتفاعش بیش از چهار نقطه باشد

فراخوانی‌های متنی (callout)، تفاوت‌ها یا تورفتگی‌های مستطیل، جلوه‌های قاب، ورودی چرخش، intent غیر FreeText، حاشیه‌نویسی‌های غیرکدر، قاب‌های گرد و سبک‌های قاب غیر از پیوسته یا خط‌چین با EArgumentException رد می‌شوند

مؤلفه‌های پس‌زمینهٔ DeviceGray و DeviceRGB و DeviceCMYK باید بین صفر و یک باشند؛ پهنای قاب‌ها و الگوهای خط‌چین باید معتبر، متناهی و نامنفی باشند و الگوی خط‌چین غیرخالی که همه‌اش صفر باشد رد می‌شود

اعتبارسنجی ورودی پشتیبانی‌نشده پیش از جایگزینی حاشیه‌نویسی یا ظاهر آن انجام می‌شود

مثال

برای سند بارگذاری‌شده‌ای که اولین حاشیه‌نویسی آن در صفحهٔ صفر یک حاشیه‌نویسی FreeText پشتیبانی‌شده است

PDF.SetLoadedFreeTextPlainText(0, 0,
  'Updated review note'#13#10'Second line', 12);

APIهای مرتبط

SetLoadedAnnotationContents فقط رشتهٔ contents ذخیره‌شده را تغییر می‌دهد و ظاهر موجود را حفظ می‌کند

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · صفحهٔ اصلی