NewFormField

Formularfelder

Beschreibung

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können.

Bei Feldern vom Typ Text, Pushbutton, Checkbox, Choice und Signature wird das Feld außerdem als Widget-Anmerkung an die aktuelle Seite angehängt und erhält einen Seitenverweis /P. Da /P für Anmerkungen ein Eintrag ab PDF 1.3 ist, wird beim Erstellen solcher Felder in einem PDF-1.2-Dokument automatisch PDF 1.3 ausgewählt. Signaturfelder können weiterhin PDF 1.5 erfordern, wenn die erzeugten AcroForm-Signaturflags dies verlangen.

Syntax

Delphi

Function TPDFlib.NewFormField(Const Title: WideString; FieldType: Integer): Integer;

ActiveX

Function PDFlib::NewFormField(Title As String, FieldType As Long) As Long

DLL

int DLNewFormField(int InstanceID, const wchar_t * Title, int FieldType);

Parameter

Title	Der Titel des neuen Formularfelds. Der Titel darf das Punktzeichen "." nicht enthalten.
FieldType	Der Typ des zu erstellenden Felds: 1 = Text 2 = Druckschaltfläche 3 = Kontrollkästchen 4 = Optionsfeld 5 = Auswahl 6 = Signatur 7 = Übergeordnetes Feld

Rückgabewerte

0	Das neue Formularfeld konnte nicht erstellt werden
Non-zero	Das Formularfeld wurde erfolgreich erstellt; dies ist der Index des neuen Felds