الطريقة THotPDF.SetLoadedFreeTextText

تستبدل المظهر العادي لتعليق FreeText توضيحي مُحمَّل مستخدمة خطوط Unicode مضمّنة ونصًا غنيًا (rich text) اختياريًا ومعاملة (transaction) ذرّية على الرسم البياني

التصريح

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

الخيارات

هيّئ السجل (record) بـ THPDFLoadedTextAppearanceOptions.Default قبل تغيير الحقول المنفردة

الحقلالسلوك
FontName, FontStyle, FontSizeالخط الأساسي ونمطه وحجمه بالنقاط؛ والقيم الافتراضية Arial وعادي و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 وDefaultStyle الاختياري من CSS، ثم يشتق /Contents من النص المولَّد

ينسخ المظهر المولَّد الخطوط المضمّنة وتعيينات ToUnicode إلى المستند المُحمَّل، لذلك تحافظ عمليات الحفظ والتسطيح (flattening) واستخراج النص على نصه Unicode

ترث الطريقة سلاسل الخطوط الاحتياطية (fallback) المضبوطة وShapingFeatures ومفاتيح التشكيل التلقائي للعربية والسريانية والنكو (N'Ko) والأدلم (Adlam) والروهينيا الخانيفية (Hanifi Rohingya) واختيارات نص ولغة GSUB؛ وتستخدم كل محاولة تقليص ليلائم الحجم الإعدادات نفسها دون تغيير تهيئة المستدعي

تحافظ الطريقة على الخلفية المدعومة والحدود الصلبة أو المتقطعة والإزاحات الداخلية للمستطيل وهندسة callout ذات النقطتين أو الثلاث نقاط، وتزامن /AP و/Contents و/RC و/DS و/CA و/Q والبيانات الوصفية للدوران

الهندسة غير الصالحة أو الحروف (glyphs) غير المحلولة في النص العادي أو الحدود السحابية (cloudy) أو حدود الموارد أو التجاوز المرفوض ترفع استثناءً وتتراجع عن التحديث بالكامل؛ وتظل معاملات الرسم البياني الخارجية نشطة

يتبع النص الغني المجموعة الجزئية المدعومة من HTML/CSS؛ والموارد الخارجية معطَّلة، وقد تمنع أحجام خطوط CSS الثابتة shrink-to-fit من تقليص التشغيلات (runs) المنفردة

يقبل كل كاتب مظاهر 256 اختيارًا كحد أقصى من اختيارات خطوط التشكيل (shaping) و64 MiB من بيانات الخطوط الخام التراكمية؛ وتجاوز أيًّا من الحدين يرفض التحديث ويحافظ على التعليق التوضيحي الأصلي

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