THPDFHeadlessDocument.SetTextFieldValueWithAppearance

procedure SetTextFieldValueWithAppearance(FieldIndex: Integer;
  const Text: UnicodeString; const TrueTypeFont: SysUtils.TBytes;
  const Options: THPDFHeadlessTextAppearanceOptions);

تحدّث حقل نص AcroForm طرفيًا قابلًا للكتابة وتبني مظهرًا عاديًا صريحًا لكل widget قائم، مستخدمةً الرسم البياني لكائنات المستند نفسه على Linux وWindows الأصليين

مستطيلات widgets تزوّد أبعاد المظهر؛ وQ الموروث للحقل يزوّد المحاذاة يسارًا أو وسطًا أو يمينًا عند حضوره، وإلا سارت محاذاة الخيارات

الملف يدعم نص plain أحادي السطر ومتعدد الأسطر والتفاف كلمات مقيسًا مع fallback محارف وفواصل أسطر CR/LF وحجمًا ثابتًا أو auto-fit وخلایا comb بـ MaxLen موروث موجب ودورانات widgets بمضاعفات 90 درجة

النصوص المعقدة ومسارات bidi وligatures ومقاطع التجميع تستخدم HarfBuzz وFriBidi عندما يكون ShapeComplexText مفعلًا؛ والنص Unicode المباشر يبقى مستقلًا عن تلك بيئات التشغيل، والمحارف الرسومية المفقودة أو ثنائيات surrogate المشوهة تنتج تشخيص مظهر

الالتفاف المتعدد الأسطر المعقد يعمل على عناقيد Unicode المنطقية قبل إعادة ترتيب bidi وإعادة التشكيل؛ وخلایا comb تحفظ ملف محرف رسومي واحد لكل scalar مباشرًا

لحقل rich-text قائم، تستبدل هذه الطريقة المحتوى بنمط plain واحد وتزامن V وRV ومظهر كل widget؛ استخدم SetRichTextFieldValueWithAppearance لتزويد أنماط مختلطة

حقول كلمة السر تولّد نقطة واحدة لكل Unicode scalar وتحفظ قيمة حقل Unicode الفعلية في V؛ وخرائط محارف مظهر النص ونص الوصول يحتويان القناع، بينما تتبع القيمة سياسة تشفير المستند

حقول كلمة السر لا يمكن أن تكون متعددة الأسطر أو comb؛ وUnicode المشوه ومحارف التحكم ومحارف القناع المفقودة والإلغاء واستنفاد الموارد يحفظون الحقل الأصلي

حقول اختيار الملف تعرض مسار Unicode النصي بوصفه نص حقل عاديًا؛ وهذه العملية لا تفتح الملف المختار ولا تنفذه ولا ترفقه

الخطوط تتطلب مخططات TrueType مسمّاة صالحة وقياسات فعلية، بأعلام تضمين قابل للتثبيت أو للتحرير؛ والتضمين الكامل للخط يكرّم أذونات no-subsetting ويرفض الأذونات المقيدة أو المعاينة والطباعة أو للصور النقطية فقط أو المفقودة أو المجهولة

تهيئ الطريقة كل بدائل الحقول وقواميس المظاهر وكائنات الخطوط وForm الجديدة وميزانيات التسلسل قبل تغيير حقل؛ وفشل preflight يحفظ قيمتها السابقة وروابط مظهرها

الكائنات الجديدة مملوكة للمستند وتُحفظ عبر الكاتب التزايدي المحدود السقف الأصلي، بما يشمل تشفير السلاسل والمسارات الجديدة تحت سياسة AES-256 R5 أو R6 الأصلية

NeedAppearances تُمسح بعد أن تغطي المظاهر الصريحة الحقل المتغيّر، ما لم يبق تعديل آخر للقيمة فقط أو متطلب مظهر أصلي غير محلول

عندما يكون العلم الأصلي true، تحفظ الحقول غير التوقيعية الأخرى بتحفظ قيمة true حتى تلبي متطلبات مظاهرها؛ استخدم أساليب الاختيار والأزرار المنفصلة لإعادة توليد تلك الحقول

القراءة فقط وMaxLen والتواقيع القائمة وأذونات التصديق وأذونات AES لملء النماذج وحماية المصدر والإلغاء وسياسات المخرجات الذرية تبقى سارية

إذا حدد المستند وخيارات المظهر كلاهما tokens إلغاء، يجب أن يكونا نفس الـ token

انظر THPDFHeadlessTextAppearanceOptions وHPDFBuildHeadlessTextAppearance لعقد الخطوط والتخطيط المحدود السقف