NewFormFieldA

Formularfelder

Beschreibung

Das abschließende A bezeichnet den ANSI-Einstiegspunkt (char) der DLL; die ActiveX/COM-Schnittstelle stellt nur die Unicode-Form bereit. Das Verhalten entspricht NewFormField, und Zeichenfolgenargumente werden anhand der aktuellen Codepage von SetAnsiMode interpretiert

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 DLNewFormFieldA(InstanceID: Integer; Title: PAnsiChar; FieldType: Integer): Integer;

DLL

int DLNewFormFieldA(int InstanceID, const char * Title, int FieldType);

Parameter

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

Rückgabewerte

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