THotPDF.SetLoadedFreeTextText-Methode

Ersetzt die Normal-Appearance einer geladenen FreeText-Annotation mit eingebetteten Unicode-Schriften, optionalem Rich Text und einer atomaren Graphtransaktion

Deklaration

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

Optionen

Initialisieren Sie den Record mit THPDFLoadedTextAppearanceOptions.Default, bevor Sie einzelne Felder ändern

FeldVerhalten
FontName, FontStyle, FontSizePrimäre Schrift, Stil und Punktgröße; Standard ist Arial, regular und 12 Punkt
TextColor, Alignment, PaddingFarbe des Klartexts, Ausrichtung links/mitte/rechts und Punkt-Padding; Standard ist Schwarz, links und 2 Punkt
Opacity, RotationDeckkraft in [0,1] und Rotation in Vielfachen von 90 Grad
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ltopReject weist Überlauf zurück, ltopClip schneidet ihn ab, und ltopShrinkToFit versucht es erneut mit kleineren Schriften
MinFontSizeUntergrenze beim Schrumpfen, Standard 4 Punkt
MaxTextUnitsBudget für Eingabe und Klartext, standardmäßig 1.048.576 UTF-16-Einheiten; Rich-Eingabe ist auf das Vierfache dieses Budgets begrenzt

Verhalten

AText liefert reinen Unicode-Text; nichtleerer UTF-8-RichContent nutzt stattdessen den HTML-Importer und optionalen CSS-DefaultStyle und leitet /Contents aus dem erzeugten Text ab

Die erzeugte Appearance kopiert eingebettete Schriften und ToUnicode-Mappings in das geladene Dokument, sodass Speichern, Flattening und Textextraktion ihren Unicode-Text behalten

Die Methode erbt konfigurierte Font-Fallback-Ketten, ShapingFeatures, die Auto-Shaping-Schalter für Arabisch, Syrisch, N'Ko, Adlam und Hanifi Rohingya sowie die GSUB-Skript- und Sprachauswahl; jeder Shrink-to-fit-Versuch nutzt dieselben Einstellungen, ohne die Konfiguration des Aufrufers zu ändern

Sie bewahrt unterstützten Hintergrund, durchgezogene/gestrichelte Umrandung, Rechteck-Insets und Zwei-/Dreipunkt-Callout-Geometrie und synchronisiert /AP, /Contents, /RC, /DS, /CA, /Q und Rotationsmetadaten

Ungültige Geometrie, ungelöste Klartext-Glyphen, Cloudy-Umrandungen, Ressourcengrenzen und zurückgewiesener Überlauf werfen eine Exception und rollen das gesamte Update zurück; bestehende äußere Graphtransaktionen bleiben aktiv

Rich Text folgt der unterstützten HTML/CSS-Teilmenge; externe Ressourcen sind deaktiviert, und feste CSS-Schriftgrößen können verhindern, dass Shrink-to-fit einzelne Läufe verkleinert

Jeder Appearance-Writer akzeptiert höchstens 256 verschiedene Shaping-Schriftauswahlen und 64 MiB kumulativer Rohschriftdaten; eine der beiden Grenzen zu überschreiten weist das Update zurück und bewahrt die ursprüngliche Annotation

Verwandte APIs