THotPDF.SetLoadedFreeTextText Method

Înlocuiește aparența normală a unei adnotări FreeText încărcate folosind fonturi Unicode încorporate, rich text opțional și o tranzacție atomică de graf

Declarație

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

Opțiuni

Inițializați înregistrarea cu THPDFLoadedTextAppearanceOptions.Default înainte de a schimba câmpurile individuale

CâmpComportament
FontName, FontStyle, FontSizeFont principal, stil și dimensiune în puncte; valorile implicite sunt Arial, regular și 12 puncte
TextColor, Alignment, PaddingCuloarea textului simplu, alinierea stânga/centru/dreapta și padding-ul în puncte; valorile implicite sunt negru, stânga și 2 puncte
Opacity, RotationOpacitate în [0,1] și rotație în multipli de 90 de grade
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ltopReject respinge depășirea, ltopClip o taie, iar ltopShrinkToFit reia cu fonturi mai mici
MinFontSizeLimita inferioară pentru micșorare, implicit 4 puncte
MaxTextUnitsBugetul de intrare și de text simplu, implicit 1,048,576 unități UTF-16; intrarea rich este limitată la de patru ori acest buget

Comportament

AText furnizează text Unicode simplu; un RichContent UTF-8 nevid folosește în schimb importer-ul HTML și DefaultStyle CSS opțional, apoi derivă /Contents din textul generat

Aparența generată copiază fonturile încorporate și mapările ToUnicode în documentul încărcat, astfel încât salvarea, aplatizarea și extracția de text îi păstrează textul Unicode

Metoda moștenește lanțurile configurate de fallback de fonturi, ShapingFeatures, comutatoarele de auto-shaping pentru Arabic, Syriac, N'Ko, Adlam și Hanifi Rohingya și selecțiile de script și de limbă GSUB; fiecare reîncercare shrink-to-fit folosește aceleași setări fără a schimba configurația apelantului

Păstrează fundalul suportat, bordura solidă/întreruptă, inset-urile de dreptunghi și geometria de callout cu două/trei puncte și sincronizează /AP, /Contents, /RC, /DS, /CA, /Q și metadatele de rotație

Geometria invalidă, glifele nerezolvate de text simplu, bordurile cloudy, limitele de resurse și depășirea respinsă ridică o excepție și fac rollback întregii actualizări; tranzacțiile exterioare existente de graf rămân active

Rich text-ul urmează subsetul HTML/CSS suportat; resursele externe sunt dezactivate, iar dimensiunile fixe de font CSS pot împiedica shrink-to-fit să reducă execuțiile individuale de text

Fiecare writer de aparențe acceptă cel mult 256 de selecții distincte de fonturi de shaping și 64 MiB de date brute de font cumulate; depășirea oricăreia dintre limite respinge actualizarea și păstrează adnotarea originală

API-uri asociate