PDFium Component Docs

FormFieldAt Eigenschaft

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.
Komponente: TPdf  ·  Unit: PDFium
Lesen oder schreiben Sie den Wert des Formularfelds an der angegebenen Seitenkoordinate

Syntax

property FormFieldAt[X, Y: Single]: WString; // lesen / schreiben

Beschreibung

FormFieldAt sucht die AcroForm-Widget-Annotation, die den Seitenraum-Punkt (X, Y) enthält, und stellt ihren Wert als Unicode-Zeichenkette bereit Die Koordinaten liegen im PDF-Benutzerraum, mit dem Ursprung in der linken unteren Ecke der Seite und Einheiten in Punkten (1/72 Zoll) Das Lesen der Eigenschaft liefert den aktuellen Feldwert (/V) als WString dekodiert; das Schreiben aktualisiert das Feld und erzeugt die Appearance-Streams neu, sodass der neue Wert beim nächsten Rendern erscheint

Gibt eine leere Zeichenkette zurück, wenn Active False ist, wenn das Dokument kein AcroForm hat oder wenn kein Widget die Koordinate abdeckt Die Zuordnungsregel entspricht FormFieldInfoAt: nur Widget-Rechtecke, kein hit-testing anhand der Erscheinung, bei Überlappungen gewinnt das oberste Widget Schreibvorgänge sind No-ops, wenn die Koordinate kein Widget trifft

Für Kontrollkästchen- und Optionsfeld-Widgets folgen die Wertsemantiken der PDF-Spezifikation — 'Off' löscht das Feld, ein Wert, der zum /AP /N-On-State-Namen des Widgets passt (häufig 'Yes' oder der Exportwert), aktiviert es Bei Textfeldern wird alles, was Sie zuweisen, zum neuen /V-Inhalt Listen- / Kombinationsfelder akzeptieren den Exportwert eines der Optionseinträge Verwenden Sie zuerst FormFieldInfoAt, um FieldType zu prüfen, wenn der Feldtyp unklar ist

Hinweise

Beispiel

// Ein Kontrollkästchen an (120, 300) auf der aktuellen Seite umschalten
if Pdf1.FormFieldAt[120.0, 300.0] = 'Off' then
  Pdf1.FormFieldAt[120.0, 300.0] := 'Yes'
else
  Pdf1.FormFieldAt[120.0, 300.0] := 'Off';

Siehe auch

FormFieldInfoAt, HasFormFieldAt, FormField, FormFieldCount