THotPDF.SetLoadedFreeTextPlainText-Methode

Konvertiert eine unterstützte geladene FreeText-Annotation ausdrücklich in linksbündigen Plain-Text und baut ihre normale Darstellung neu auf

Deklaration

procedure SetLoadedFreeTextPlainText(PageIndex, AnnotationIndex: Integer;
  const AText: AnsiString; FontSize: Single = 12);

Einheit: HPDFDoc · Verfügbar seit Version 2.753.0

Parameter

PageIndex: nullbasierter Index der geladenen Seite
AnnotationIndex: nullbasierter Annotationsindex auf dieser Seite
AText: druckbare ASCII-Zeichen, mit CR, LF oder CR/LF für explizite Zeilenumbrüche; Tabs, andere Steuerzeichen und nicht-ASCII-Text werden zurückgewiesen
FontSize: endliche Größe in PDF-Punkten, größer als null und höchstens 10.000, standardmäßig 12

Darstellungskonvertierung

Die Methode verwendet schwarzen Helvetica-Text und einen schwarzen rechteckigen Rahmen, behält eine unterstützte Device-Color-Hintergrundfarbe sowie durchgezogene oder gestrichelte Rahmengeometrie bei und schneidet Text auf einen Two-Point-Inset innerhalb des Annotationsrechtecks zu

Zeilen rücken um das 1,2-Fache der Schriftgröße vor; automatischer Umbruch oder Shrink-to-Fit gibt es nicht, Text außerhalb des Insets wird abgeschnitten

Die Konvertierung ersetzt /AP, aktualisiert /Contents und /DA, setzt /Q auf null und entfernt /RC, /DS und /AS; der alte Rich-Text, die Schriftauswahl, Textfarbe, Ausrichtung und die Appearance-States werden bewusst ersetzt

Annotations-, Appearance- und Seitenänderungen werden für inkrementelles Speichern registriert, und der Seiten-Render-Cache wird ungültig gemacht; Rewrite-Speichern bewahrt die neue Darstellung ebenfalls

Unterstützte Eingaben und Fehler

Die Annotation muss mit Subtype FreeText existieren und ein endliches Rechteck haben, das breiter und höher als vier Punkte ist

Callouts, Rechteck-Differenzen oder Insets, Border-Effekte, ein Rotation-Eintrag, nicht-FreeText-Intent, nicht-opake Annotationen, abgerundete Rahmen und Rahmenstile außer durchgezogen oder gestrichelt werden mit EArgumentException zurückgewiesen

DeviceGray-, DeviceRGB- und DeviceCMYK-Hintergrundkomponenten müssen im Bereich null bis eins liegen; Rahmenbreiten und Dash-Patterns müssen gültig, endlich und nicht-negativ sein, und ein nicht-leeres allzero Dash-Pattern wird zurückgewiesen

Nicht unterstützte Eingaben werden validiert, bevor die Annotation oder ihre Darstellung ersetzt wird

Beispiel

Für ein geladenes Dokument, dessen erste Annotation auf Seite null eine unterstützte FreeText-Annotation ist