Arbeiten mit Formularfeldern
Ein Dokument, das ausfüllbare Leerzeichen (Felder) enthält, wird als Formular bezeichnet. Sie können beispielsweise ein Registrierungsformular in Microsoft Word erstellen, das Dropdown-Listen verwendet, aus denen Benutzer Einträge auswählen können. Das Feld Form ist ein Speicherort für einen bestimmten Datentyp, z. B. einen Namen oder eine Adresse. Formularfelder in Microsoft Word enthalten Texteingaben, combobox und checkbox.
Sie können Formularfelder in Ihrem Projekt verwenden, um mit Ihren Benutzern zu “kommunizieren”. Sie erstellen beispielsweise ein Dokument, dessen Inhalt geschützt ist, aber nur Formularfelder bearbeitet werden können. Die Benutzer können die Daten in die Formularfelder eingeben und das Dokument absenden. Ihre Anwendung, die Aspose.Words verwendet, kann Daten aus den Formularfeldern abrufen und verarbeiten.
Das Einfügen von Formularfeldern in das Dokument per Code ist einfach. DocumentBuilder verfügt über spezielle Methoden zum Einfügen, eine für jeden Formularfeldtyp. Jede der Methoden akzeptiert einen Zeichenfolgenparameter, der den Namen des Formularfelds darstellt. Der Name kann eine leere Zeichenfolge sein. Wenn Sie jedoch einen Namen für das Formularfeld angeben, wird automatisch ein Lesezeichen mit demselben Namen erstellt.
Formularfelder einfügen
Formularfelder sind ein besonderer Fall von Wortfeldern, die eine “Interaktion” mit dem Benutzer ermöglichen. Formularfelder in Microsoft Word enthalten Textfeld, Kombinationsfeld und checkbox.
DocumentBuilder
Das folgende Codebeispiel zeigt, wie Sie ein combobox-Formularfeld in ein Dokument einfügen:
Fügen Sie eine Texteingabe ein
Verwenden Sie die Methode insertTextInput, um ein Textfeld in das Dokument einzufügen.
Das folgende Codebeispiel zeigt, wie Sie ein Texteingabeformularfeld in ein Dokument einfügen:
Kontrollkästchen einfügen
Rufen Sie insertCheckBox auf, um eine checkbox in das Dokument einzufügen.
Das folgende Codebeispiel zeigt, wie Sie ein checkbox-Formularfeld in ein Dokument einfügen:
Einfügen eines Kombinationsfelds
Rufen Sie insertComboBox auf, um eine combobox in das Dokument einzufügen.
Das folgende Codebeispiel zeigt, wie Sie ein Combobox-Formularfeld in ein Dokument einfügen:
Formularfelder abrufen
Eine Sammlung von Formularfeldern wird durch die Klasse FormFieldCollection dargestellt, die mit der Eigenschaft Range.getFormFields abgerufen werden kann. Dies bedeutet, dass Sie Formularfelder abrufen können, die in jedem Dokumentknoten enthalten sind, einschließlich des Dokuments selbst.
Das folgende Codebeispiel zeigt, wie Sie eine Sammlung von Formularfeldern abrufen:
Sie können ein bestimmtes Formularfeld anhand seines Index oder Namens abrufen.
Das folgende Codebeispiel zeigt, wie auf Formularfelder zugegriffen wird:
Mit den FormField-Eigenschaften können Sie mit Name, Typ und Ergebnis des Formularfelds arbeiten.
Das folgende Codebeispiel zeigt, wie Sie mit Name, Typ und Ergebnis des Formularfelds arbeiten: