Bearbeitungsmethoden für geladene THotPDF-Formularfelder

Aktualisiert Feldeinschränkungen und Widget-Darstellungswörterbücher eines AcroForm-Dokuments bei korrektem inkrementellem Speichern und Rendercache

Methoden auf Feldebene

procedure SetLoadedFormFieldFlags(FieldIndex, AFlags: Integer);
procedure SetLoadedFormFieldMaxLength(FieldIndex, AMaxLength: Integer);
procedure SetLoadedFormFieldJustification(FieldIndex: Integer;
  AJustification: THPDFFormFieldJustification);

• SetLoadedFormFieldFlags ersetzt die gesamte /Ff-Bitmaske
• SetLoadedFormFieldMaxLength schreibt /MaxLen; null oder negative Werte entfernen die Begrenzung
• THPDFFormFieldJustification ordnet ffjLeft, ffjCenter und ffjRight den /Q-Werten 0 bis 2 zu

Widget-Geometrie

function GetLoadedFormFieldWidgetCount(FieldIndex: Integer): Integer;
function GetLoadedFormFieldWidgetRect(FieldIndex, WidgetIndex: Integer; out ARect: THPDFRect): boolean;
procedure SetLoadedFormFieldWidgetRect(FieldIndex, WidgetIndex: Integer; X1, Y1, X2, Y2: Single);

• Feld- und Widget-Indizes sind nullbasiert
• Die Aufzählung umfasst alle /Kids-Einträge mehrerer Widgets
• Rechteckendpunkte verwenden PDF-Benutzerraumpunkte und werden vor dem Schreiben normalisiert

Darstellung und Sichtbarkeit

procedure SetLoadedFormFieldRotation(FieldIndex, ADegrees: Integer);
procedure SetLoadedFormFieldBorderColor(FieldIndex: Integer;
  ARed, AGreen, ABlue: Single);
procedure SetLoadedFormFieldVisibility(FieldIndex: Integer;
  AVisible, APrintable: boolean);
procedure SetLoadedFormFieldBorderWidth(FieldIndex: Integer; AWidth: Single);
procedure SetLoadedFormFieldBackgroundColor(FieldIndex: Integer;
  ARed, AGreen, ABlue: Single);

• Drehungen akzeptieren positive oder negative Vielfache von 90 Grad und speichern den normalisierten /MK /R-Wert
• RGB-Komponenten für Rahmen und Hintergrund werden auf den PDF-DeviceRGB-Bereich von 0 bis 1 begrenzt
• Die Methoden für Darstellung und Sichtbarkeit aktualisieren jedes Widget des ausgewählten Feldes
• Die Sichtbarkeit bewahrt nicht betroffene Anmerkungsflags und steuert dabei Hidden, NoView und Print

Inkrementelles Aktualisierungsverhalten

• Feld-, Widget-, /MK- und /BS-Wörterbücher werden auf der Ebene als geändert markiert, auf der der jeweilige Wert gespeichert ist
• Visuelle Änderungen machen nur die zwischengespeicherten DPI-Varianten der betroffenen Seite ungültig
• Ungültige Feld- oder Widget-Indizes lassen das Dokument unverändert

Beispiel

PDF.BeginIncrementalUpdate('input.pdf');
PDF.SetLoadedFormFieldMaxLength(0, 40);
PDF.SetLoadedFormFieldJustification(0, ffjCenter);
PDF.SetLoadedFormFieldRotation(0, 90);
PDF.SetLoadedFormFieldBorderColor(0, 0.1, 0.4, 0.8);
PDF.SetLoadedFormFieldWidgetRect(1, 1, 80, 150, 100, 170);
PDF.SaveIncrementalUpdate('updated.pdf');

Verwandte APIs

Geladene Formularfeldmethoden · Toolkit für geladene Dokumente