Erweiterte Methoden von THPDFPage

Diese Seite sammelt Methoden auf Seitenebene, die in THPDFPage öffentlich sind und in fortgeschrittenen Erstellungsworkflows nützlich sind, aber noch keine separaten Themenseiten haben

Markup- und Rich-Anmerkungen

Methode	Verwendung
`AddHighlightAnnotation`, `AddUnderlineAnnotation`, `AddSquigglyAnnotation`, `AddStrikeOutAnnotation`	Erstellt Textmarkierungsanmerkungen über einen rechteckigen Textbereich; HotPDF gibt den entsprechenden PDF 1.7-Untertyp aus und leitet `/QuadPoints` aus dem Rechteck ab
`AddPolylineAnnotation`, `AddPolygonAnnotation`	Erstellt PDF 1.7-Polylinien- oder Polygon-Überprüfungsanmerkungen aus einem Array von `THPDFCurrPoint`-Scheitelpunkten; die Überladungen mit `THPDFPolyExtras` fügen optionale Innenfarben, wolkenartige Rahmen, Absichten und Linienenden-Details hinzu
`HPDFDefaultLineExtras`, `HPDFDefaultPolyExtras`	Gibt null-initialisierte `THPDFLineExtras`- und `THPDFPolyExtras`-Datensätze zurück, sodass Aufrufer nur die optionalen Linien- oder Polygon-Anmerkungsfelder festlegen können, die sie benötigen
`AddInkAnnotation`, `AddCaretAnnotation`	Fügt Freihand-Überprüfungsmarkierungen oder Einfügungsmarken (Caret) hinzu; verwenden Sie LastAnnotation mit SetAnnotationBorderStyle, wenn das Rahmenstyling nach der Erstellung angepasst werden muss
`AddScreenAnnotation`, `AddWatermarkAnnotation`, `AddRedactAnnotation`	Fügt Multimedia-Bildschirm-, Festdruck-Wasserzeichen- oder Schwärzungsanmerkungen hinzu; diese Methoden folgen denselben PDF-Versions- und Konformitätsprüfungen wie die entsprechenden Anmerkungsuntertypen
`Add3DAnnotation`, `AddRichMediaAnnotation`	Fügt interaktive PDF 1.7-Medienanmerkungen hinzu; diese sind für Viewer-Workflows gedacht, die eingebettete 3D- oder Rich-Media-Inhalte explizit unterstützen, und eignen sich nicht für die archivtaugliche PDF/A-Ausgabe
`AddPopupAnnotation`	Erstellt direkt eine Popup-Anmerkung; wenn das Popup an eine andere Anmerkung angehängt werden soll, bevorzugen Sie AddPopupAnnotationFor

Erweiterungen für Schaltflächenaktionen

Methode	Beschreibung
`AddPushButtonWithHideAction`	Erstellt eine Drucktaste, deren Aktion ein oder mehrere Formularfelder ausblendet oder anzeigt; dies ist nützlich, wenn ein Formular optionale Abschnitte ohne Ausführung von JavaScript benötigt
`AddPushButtonWithSubmitAction`	Erstellt eine Senden-Schaltfläche mit expliziten `THPDFSubmitFormFlags`, sodass der Aufrufer FDF, HTML, XFDF, PDF, GET/POST und zugehörige Übermittlungsoptionen steuert
`AddPushButtonWithRenditionAction`	Erstellt eine Drucktaste, die eine Renditionsaktion steuert, die an eine Bildschirmanmerkung und eine Mediendatei gebunden ist; PDF/A- und PDF/X-Konformitätsmodi lehnen Multimedia-Aktionen ab
`AddPushButtonWithSoundAction`	Erstellt eine Drucktaste, die einen eingebetteten PDF-/Sound abspielt; Überladungen akzeptieren entweder einen Dateinamen oder vom Aufrufer bereitgestellte rohe Sound-Bytes mit `THPDFSoundParams`
`AddPushButtonWithMovieAction`	Erstellt eine ältere Movie-Aktionsschaltfläche, die auf das von `AddMovieAnnotation` zurückgelieferte Wörterbuch verweist

Seitenboxen und Anzeige-Steuerelemente

Methode oder Eigenschaft	Beschreibung
`SetCropBox`, `SetBleedBox`, `SetTrimBox`, `SetArtBox`	Hängt die optionalen, in ISO 32000-1 §14.11.2 definierten Produktionsseitenboxen an; `MediaBox` verfolgt weiterhin die physische Papiergröße; nicht festgelegte Boxen fallen über die Standard-PDF-Standardkette zurück
`SetPageRotation`	Legt den Eintrag `/Rotate` der Seite fest; Werte werden auf die vom PDF geforderten Vielfachen von 90 Grad im Bereich `0..359` normalisiert
`SetUserUnit`	Legt die PDF 1.6 `/UserUnit` für sehr große Seiten fest; die Übergabe von `0` entfernt den Eintrag und setzt die Seite auf die Standardeinheitenskalierung zurück
`SetTabsOrder`	Legt die Tab-Reihenfolge der Seitenanmerkungen über den Eintrag `/Tabs` fest; verwenden Sie `R`, `C`, `S`, `A` oder `W` gemäß der PDF-Spezifikation
`DocScale`	Passt die von Kompatibilitätszeichenpfaden verwendete Seitenzeichnungsskalierung an; belassen Sie den Standardwert, es sei denn, der Aufrufer benötigt ausdrücklich skalierte ältere Koordinaten

Transparenz und optionaler Inhalt

Methode	Beschreibung
`SetTransparencyGroup`, `SetTransparencyGroupICC`, `ClearTransparencyGroup`	Hängt ein Seitenwörterbuch `/Group` an oder entfernt es, sodass alphahaltige Inhalte als PDF-Transparenzgruppe zusammengesetzt werden; die ICC-Variante verweist auf ein im Dokument registriertes ICC-Profil
`BeginOptionalContent`, `EndOptionalContent`	Hüllt nachfolgende Seitenzeichnungen in eine markierte Inhaltssequenz für optionalen Inhalt gemäß PDF 1.5 ein; registrieren Sie die Ebene zuerst mit `THotPDF.RegisterOptionalContentGroup`

Strukturierter Inhalt und Type 3-Schriftarten

Methode	Beschreibung
`BeginMarkedContentMCIDProps`	Beginnt eine markierte Inhaltssequenz mit einem Inline-Eigenschaftswörterbuch, das `/MCID` sowie optionale Einträge `/Lang`, `/Alt`, `/ActualText` und `/E` enthält; verwenden Sie `EndMarkedContent`, um die Sequenz zu schließen
`SetType3Font`	Wählt eine über `THotPDF.RegisterType3Font` registrierte Type 3-Schriftart aus, sodass nachfolgende `ShowText`-Aufrufe Text mit vom Aufrufer definierten Glyphen-Streams ausgeben

Textpositionierung und Kompatibilitätshilfen

Methode	Beschreibung
`SetCharacterSpacing`, `SetTextMatrix`, `MoveToNextLine`	Gibt Low-Level-PDF-Textzustands- und Positionierungsoperatoren für Aufrufer aus, die eine direkte Kontrolle über `TextOut`, `UnicodeTextOut` oder die Textbox-Hilfsmittel hinaus benötigen
`SetRGBHyperlinkColor`	Legt die von `PrintHyperlink` verwendete RGB-Farbe fest; die veröffentlichte Eigenschaft `HyperlinkColor` ruft diesen Setter auf
`FMEllipse`, `MFRectangle`	Ältere Zeichnungs-Aliase, die zur Abwärtskompatibilität mit älterem Aufrufercode beibehalten wurden; bevorzugen Sie für neuen Code `Ellipse` und `Rectangle`
`DirectDrawBarcode`	Zeichnet einen Barcode unter Verwendung direkter Seitenkoordinaten und eines numerischen Barcodetyps; bevorzugen Sie für typisierten Code `DrawBarcode` mit der Aufzählung `THPDFBarcodeType`
`TextOutStr`, `OutText`, `RtLTextOutStr`, `SetFontAndSize`, `ShowMetafileEx`	Kompatibilitäts-Aliase oder C++Builder-spezifische Einstiegspunkte, die für bestehenden Code weiterhin verfügbar sind; neuer Code kann normalerweise `TextOut`, `RtLTextOut`, `SetFont` und `ShowMetafile` verwenden
`Debug_GetProcessedRtlString`, `ProcessFont`	Diagnose- und Low-Level-Hilfsfunktionen, die von der Klasse offengelegt werden; sie werden hier zur API-Sichtbarkeit dokumentiert; die normale Dokumentgenerierung sollte die höherwertigen Text- und Schriftartmethoden verwenden

Hilfsfunktionen für digitale Signaturfelder

AttachPAdESSeedValue - Hängt ein PAdES-Seed-Wert-Wörterbuch (Seed Value) an ein vorhandenes Signaturfeld an, sodass der Viewer vor dem Signieren Digest-, Subfilter-, Grund-, Standort-, Kontakt-, Zeitstempel- und Zertifikatseinschränkungen anzeigen kann; erstellen Sie das Feld zuerst mit AddPAdESSignatureField oder einer anderen Signaturfeld-Hilfsfunktion und rufen Sie dann AttachPAdESSeedValue mit dem Feldnamen und den THPDFPAdESSeedValue-Einstellungen auf