เมธอด THotPDF.SetLoadedFreeTextText

แทนที่ normal appearance ของคำอธิบายประกอบ FreeText ที่โหลดมา ด้วยฟอนต์ Unicode ที่ฝังไว้ rich text แบบไม่บังคับ และ transaction ของ graph แบบอะตอม

การประกาศ

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

ตัวเลือก

เริ่มต้นระเบียนด้วย THPDFLoadedTextAppearanceOptions.Default ก่อนแก้ฟิลด์เฉพาะตัว

ฟิลด์พฤติกรรม
FontName, FontStyle, FontSizeฟอนต์หลัก สไตล์ และขนาดพอยต์, ค่าเริ่มต้นคือ Arial, regular และ 12 พอยต์
TextColor, Alignment, Paddingสีของข้อความธรรมดา การจัดแนว left/center/right และ padding เป็นพอยต์, ค่าเริ่มต้นคือ black, left และ 2 พอยต์
Opacity, Rotationopacity ในช่วง [0,1] และการหมุนเป็นพหุคูณของ 90 องศา
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ltopReject ปฏิเสธ overflow, ltopClip ตัดส่วนเกินทิ้ง และ ltopShrinkToFit ลองฟอนต์เล็กลงใหม่
MinFontSizeขอบล่างของการหดฟอนต์, ค่าเริ่มต้น 4 พอยต์
MaxTextUnitsงบประมาณของ input และข้อความธรรมดา, ค่าเริ่มต้น 1,048,576 หน่วย UTF-16, input แบบ rich ถูกจำกัดที่สี่เท่าของงบประมาณนี้

พฤติกรรม

AText ให้ข้อความ Unicode ธรรมดา ถ้า RichContent เป็น UTF-8 ที่ไม่ว่าง จะเปลี่ยนไปใช้ HTML importer กับ CSS DefaultStyle แบบไม่บังคับ แล้วสร้าง /Contents จากข้อความที่ได้

appearance ที่สร้างขึ้นจะคัดลอกฟอนต์ที่ฝังและ mapping ToUnicode ลงในเอกสารที่โหลดมา การบันทึก การ flatten และการดึงข้อความจึงยังเห็นข้อความ Unicode ของมัน

เมธอดนี้รับห่วงโซ่ font fallback ที่ตั้งไว้, ShapingFeatures, สวิตช์ auto-shaping ของ Arabic, Syriac, N'Ko, Adlam และ Hanifi Rohingya และการเลือก script กับภาษาของ GSUB มาใช้, การลอง shrink-to-fit แต่ละรอบใช้ค่าเดิมทั้งหมด โดยไม่แก้ configuration ของผู้เรียก

คง background ที่รองรับ, border แบบทึบ/เส้นประ, rectangle inset และเรขาคณิต callout แบบสอง/สามจุดไว้ พร้อม sync /AP, /Contents, /RC, /DS, /CA, /Q และ metadata การหมุน

เรขาคณิตที่ไม่ถูกต้อง, glyph ของข้อความธรรมดาที่ resolve ไม่ได้, border แบบ cloudy, ลิมิตทรัพยากร และ overflow ที่ถูกปฏิเสธ จะ raise exception และ rollback การอัปเดตทั้งหมด, transaction ของ graph ชั้นนอกที่มีอยู่ยังคงทำงานต่อ

rich text ยึดตามชุดย่อย HTML/CSS ที่รองรับ, external resource ถูกปิด และขนาดฟอนต์ CSS แบบคงที่อาจทำให้ shrink-to-fit หด text run รายตัวไม่ได้

appearance writer แต่ละตัวรับ shaping font selection ที่ต่างกันได้สูงสุด 256 แบบ และข้อมูลฟอนต์ดิบสะสม 64 MiB, เกินขีดจำกัดใดขีดหนึ่งจะปฏิเสธการอัปเดตและคงคำอธิบายประกอบเดิมไว้

API ที่เกี่ยวข้อง