Utilisation des champs de formulaire
Un document qui contient des blancs à remplir (champs) est appelé formulaire. Par exemple, vous pouvez créer un formulaire d’inscription dans Microsoft Word qui utilise des listes déroulantes à partir desquelles les utilisateurs peuvent sélectionner des entrées. Le champ Form est un emplacement où un type particulier de données, tel qu’un nom ou une adresse, est stocké. Les champs de formulaire dans Microsoft Word incluent la saisie de texte, combobox et checkbox.
Vous pouvez utiliser des champs de formulaire dans votre projet pour “communiquer” avec vos utilisateurs. Par exemple, vous créez un document dont le contenu est protégé, mais seuls les champs de formulaire sont modifiables. Les utilisateurs peuvent saisir les données dans les champs du formulaire et soumettre le document. Votre application qui utilise Aspose.Words peut récupérer des données à partir des champs du formulaire et les traiter.
Placer des champs de formulaire dans le document via du code est facile. DocumentBuilder a des méthodes spéciales pour les insérer, une pour chaque type de champ de formulaire. Chacune des méthodes accepte un paramètre de chaîne représentant le nom du champ de formulaire. Le nom peut être une chaîne vide. Si toutefois vous spécifiez un nom pour le champ de formulaire, un signet est automatiquement créé avec le même nom.
Insérer des Champs de Formulaire
Les champs de formulaire sont un cas particulier de champs Word qui permet une “interaction” avec l’utilisateur. Les champs de formulaire dans Microsoft Word incluent la zone de texte, la zone de liste déroulante et checkbox.
DocumentBuilder
L’exemple de code suivant montre comment insérer un champ de formulaire combobox dans un document:
Insérer une entrée de texte
Utilisez la méthode insertTextInput pour insérer une zone de texte dans le document.
L’exemple de code suivant montre comment insérer un champ de formulaire de saisie de texte dans un document:
Insérer une Case à cocher
Appelez insertCheckBox pour insérer un checkbox dans le document.
L’exemple de code suivant montre comment insérer un champ de formulaire checkbox dans un document:
Insérer une zone de liste Déroulante
Appelez insertComboBox pour insérer un combobox dans le document.
L’exemple de code suivant montre comment insérer un champ de formulaire Combobox dans un document:
Obtenir des Champs de Formulaire
Une collection de champs de formulaire est représentée par la classe FormFieldCollection qui peut être récupérée à l’aide de la propriété Range.getFormFields. Cela signifie que vous pouvez obtenir des champs de formulaire contenus dans n’importe quel nœud de document, y compris le document lui-même.
L’exemple de code suivant montre comment obtenir une collection de champs de formulaire:
Vous pouvez obtenir un champ de formulaire particulier par son index ou son nom.
L’exemple de code suivant montre comment accéder aux champs de formulaire:
Les propriétés FormField vous permettent de travailler avec le nom, le type et le résultat du champ de formulaire.
L’exemple de code suivant montre comment utiliser le nom, le type et le résultat du champ de formulaire: