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؛ أما النص الغني القديم واختيار الخط ولون النص والمحاذاة وحالات المظهر فتُستبدل عمدًا

تُسجَّل تغييرات التعليق التوضيحي والمظهر والصفحة للحفظ التزايدي، وتُبطل ذاكرة العرض المؤقتة للصفحة؛ كما يحافظ الحفظ بإعادة الكتابة على المظهر الجديد

المدخلات المدعومة والأخطاء

يجب أن يكون التعليق التوضيحي موجودًا وأن يكون نوعه الفرعي FreeText، مع مستطيل متناهٍ عرضه وارتفاعه أكبر من أربع نقاط

تُرفض مع EArgumentException الاستدعاءات التوضيحية (callouts) وفروق المستطيل أو هوامشه الداخلية وتأثيرات الإطار وإدخال الدوران والقصد (intent) غير FreeText والتعليقات التوضيحية غير المعتمة والإطارات المستديرة وأنماط الإطار خلاف المتصل أو المتقطع

يجب أن تقع مكونات الخلفية DeviceGray وDeviceRGB وDeviceCMYK بين الصفر والواحد؛ ويجب أن تكون أعرض الإطارات وأنماط الشرطات صالحة ومتناهية وغير سالبة، ويُرفض نمط الشرطات غير الفارغ المكوَّن كله من أصفار

يُتحقق من صحة المدخلات غير المدعومة قبل استبدال التعليق التوضيحي أو مظهره

مثال

لمستند محمّل يكون تعليقه التوضيحي الأول في الصفحة صفر تعليقًا توضيحيًا FreeText مدعومًا

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

واجهات برمجة التطبيقات ذات الصلة

SetLoadedAnnotationContents يغيّر فقط سلسلة المحتوى contents المخزنة ويحافظ على المظهر الحالي

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · الصفحة الرئيسية