Automatische XFA-Push-Button-Captions und -Zustände
HPDFXFAWriteHeadlessPDF erzeugt echte native Push-Button-Widgets aus dem XFA-Layout, einschließlich effektiver skalarer oder XHTML-Captions, gelieferter Font-Programme, Sichtbarkeit, Readonly-Flags und interaktiver Highlight-Metadaten
Jedes Widget hat FT Btn, das Pushbutton-Ff-Flag, eine explizite Normal-Appearance und eine Unicode-MK.CA-Caption, abgeleitet aus seinem tatsächlich gerenderten Inhalt; ein Button wird kein Texteingabefeld, und kein Platzhalter-PDF-Feld ist nötig
Eine sichtbare Normal-Caption behält zusätzlich einen DA-Eintrag, dessen Font-Alias sich über AcroForm.DR zu einer echten Normal-Caption-Type0-Schrift auflöst; keine leere Platzhalter-Schrift wird der Kompatibilität halber eingebettet
Caption-Inhalt und Layout
Skalare Caption-Schriftgröße, -Gewicht, -Lage, -Typeface und -Farbe plus XHTML-Inline-Styles und gemischte Grundlinien nutzen den bestehenden nativen Rich-Text-Decoder und Appearance-Builder
CaptionFontFamilies liefert echte Regular-, Bold-, Italic- und Bold-Italic-Programme und benannte Familien; Faces werden nie synthetisiert, und Font-Programme werden nicht gefunden oder heruntergeladen
Nur-Whitespace-Text zwischen XHTML-Inline-Elementen bleibt erhalten, sodass nebeneinanderliegend unterschiedlich stilisierte Wörter ihre verfassten Trenner bewahren
Fehlender Caption-Inhalt behält den bestehenden Feldnamen-Fallback, während explizit leerer Inhalt leer bleibt und nichtleere skalare Captions verfasste führende und nachfolgende Leerzeichen bewahren; versteckte, inaktive und unsichtbare Captions malen keinen Text und serialisieren keine regenerierbare sichtbare Caption
Feld- und Caption-Margins, Caption-Platzierung, Reserve-Wert und Absatzausrichtung bestimmen die tatsächliche Caption-Region; fehlende, null und der Schema-Default -1 als Reserve-Wert nutzen die natürliche Ausdehnung ohne automatischen Umbruch, positiver Reserve-Wert erlaubt Umbruch, und Inline-Platzierung ignoriert den Reserve-Wert
Feste Feldgrenzen beschneiden überdimensionierte Captions; explizite Absatzumbrüche bleiben aktiv, und effektive Instanz-Overlays bewahren unveränderte Template-Geschwister
Highlight- und Zustands-Appearances
| XFA-Highlight | Natives PDF-Ergebnis |
|---|---|
| inverted oder fehlend | H I mit normaler AP.N; der Reader wendet die inverted-Aktivierungsbehandlung an |
| none | H N mit normaler AP.N |
| outline | H O mit normaler AP.N; der Reader wendet die Rahmen-Aktivierungsbehandlung an |
| push | H P mit echter normaler AP.N sowie Down-AP.D- und Rollover-AP.R-Forms; die Down-Caption ist versetzt, um das Gedrücktsein darzustellen |
Im push-Modus liefern skalare items namens down und rollover ihre jeweiligen Captions und MK.AC- oder MK.RC-Metadaten; ein fehlendes Zustands-Item nutzt die normale Caption, während ein explizit leeres Item einen leeren Zustand ergibt
Alternate-Items beeinflussen andere Highlight-Modi nicht, und jeder erzeugte Zustand behält seine eigene echte Appearance und seinen gelieferten Schriftgraphen
Transaktionen und Limits
Echte wiederholte-Instanz-Ereignisänderungen lassen sich als XDP speichern, neu laden und vom Creator konsumieren; sofortiges Lesen, Overlay- und Gesamtpayload-Ersetzung, Erstinstanz-Isolation und Rollback fehlgeschlagener Ereignisse bleiben native Runtime-Operationen
Quellknoten und -bytes, Font-Programme, Glyphen-Einheiten, Objekte und Kandidaten-Bytes sind begrenzt; Abbruch und Vorbereitungsfehler bewahren Aufrufer-Stream-Bytes, -Länge und -Position
Der finale Schreibzugriff in den Stream des Aufrufers ist die Commit-Grenze; eine von diesem Stream während des Schreibens geworfene Ausnahme kann einen partiellen Schreibzugriff hinterlassen und wird nicht als zurückgerolltes nicht-seek-fähiges Ziel dargestellt
Dieser Consumer erzeugt gespeicherte Widget-Appearance-Zustände; spätere reader-getriebene XFA-Skriptausführung oder Appearance-Rebuilding, Rich-Alternate-Item-Inhalte, Button-Icons, externe Medien und beliebige Fremd-XML-Renderings bleiben separate Fähigkeiten
Die Highlight- und Caption-Reserve-Mappings folgen der XFA-3.3-button- und caption-Semantik
Emitter-Metadaten · Boolean-Rich-Captions · Automatische native XFA-Erzeugung