THotPDF.SetLoadedFreeTextText Method

Vervangt de normale appearance van een geladen FreeText-annotatie met embedded Unicode-fonts, optionele rich text en een atomische grafiektransactie

Declaratie

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

Opties

Initialiseer het record met THPDFLoadedTextAppearanceOptions.Default voordat je afzonderlijke velden wijzigt

VeldGedrag
FontName, FontStyle, FontSizePrimaire font, style en puntgrootte; de defaults zijn Arial, regular en 12 points
TextColor, Alignment, PaddingKleur van de platte tekst, left/center/right-uitlijning en point-padding; de defaults zijn zwart, left en 2 points
Opacity, RotationOpacity in [0,1] en rotatie in veelvouden van 90 graden
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ltopReject wijst overflow af, ltopClip kapt het af en ltopShrinkToFit probeert het opnieuw met kleinere fonts
MinFontSizeOndergrens voor het verkleinen, default 4 points
MaxTextUnitsBudget voor invoer en platte tekst, default 1,048,576 UTF-16-units; rich input is beperkt tot vier keer dit budget

Gedrag

AText levert platte Unicode-tekst; niet-lege UTF-8 RichContent gebruikt in plaats daarvan de HTML-importer en de optionele CSS DefaultStyle en leidt daarna /Contents af uit de gegenereerde tekst

De gegenereerde appearance kopieert embedded fonts en ToUnicode-mappings naar het geladen document, zodat opslaan, flattening en teksextractie de Unicode-tekst behouden

De methode erft geconfigureerde font-fallbackketens, ShapingFeatures, de auto-shaping-schakelaars voor Arabisch, Syriac, N'Ko, Adlam en Hanifi Rohingya en de GSUB-script- en taalselecties; elke nieuwe shrink-to-fit-poging gebruikt dezelfde instellingen zonder de configuratie van de aanroeper te wijzigen

De methode behoudt ondersteunde background, solid/dashed border, rectangle-insets en two/three-point-callout-geometrie en synchroniseert /AP, /Contents, /RC, /DS, /CA, /Q en rotatiemetadata

Ongeldige geometrie, onopgeloste plain-text-glyphs, cloudy borders, resourcelimieten en geweigerde overflow gooien een exception en rollen de volledige update terug; bestaande buitenste grafiektransacties blijven actief

Rich text volgt de ondersteunde HTML/CSS-subset; externe resources zijn uitgeschakeld en vaste CSS-fontgroottes kunnen verhinderen dat shrink-to-fit afzonderlijke runs verkleint

Elke appearance writer accepteert ten hoogste 256 verschillende shaping-fontselecties en 64 MiB cumulatieve ruwe fontdata; overschrijding van een van beide limieten wijst de update af en behoudt de oorspronkelijke annotatie

Gerelateerde API's