Explorer les fonctionnalités de la classe FormEditor

Les documents PDF contiennent parfois des formulaires interactifs, connus sous le nom d’AcroForm. C’est comme un formulaire utilisé sur les pages web. Ces formulaires contiennent différents types de contrôles, c’est-à-dire des zones de texte, des cases à cocher et des boutons, etc. Un développeur travaillant avec des fichiers PDF peut parfois avoir besoin de modifier ces formulaires. Dans cet article, nous examinerons en détail comment le namespace Aspose.Pdf.Facades nous permet de le faire.

Détails de l’implémentation

Les développeurs peuvent utiliser le namespace Aspose.Pdf.Facades non seulement pour ajouter de nouveaux formulaires et champs de formulaire dans un document PDF, mais aussi pour modifier des champs existants. La portée de cet article est limitée aux fonctionnalités de Aspose.PDF for .NET qui traitent de l’édition de formulaires.

FormEditor est la classe qui contient la plupart des méthodes et propriétés permettant aux développeurs de modifier les champs de formulaire. Vous pouvez non seulement ajouter de nouveaux champs, mais aussi supprimer des champs existants, déplacer un champ à une autre position, changer le nom du champ ou les attributs, etc. La liste des fonctionnalités fournies par cette classe est assez complète, et il est très facile de travailler avec les champs de formulaire en utilisant cette classe.

Ces méthodes peuvent être divisées en deux catégories principales, l’une étant utilisée pour manipuler les champs, et l’autre pour définir les nouveaux attributs de ces champs. Les méthodes que nous pouvons regrouper sous la première catégorie incluent AddField, AddListItem, RemoveListItem, CopyInnerField, CopyOuterField, DelListItem, MoveField, RemoveField et RenameField, etc. Dans la deuxième catégorie des méthodes, on peut inclure SetFieldAlignment, SetFieldAppearance, SetFieldAttribute, SetFieldLimit, SetFieldScript. Le code suivant vous montre certaines des méthodes de la classe FormEditor.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.Pdf-for-.NET
private static void ExploringFormEditorFeatures()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdfFacades_TechnicalArticles();

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "inFile.pdf"))
    {
        // Create instance of FormEditor
        using (var editor = new Aspose.Pdf.Facades.FormEditor(document))
        {
            // Add field in the PDF file
            editor.AddField(Aspose.Pdf.Facades.FieldType.Text, "field1", 1, 300, 500, 350, 525);

            // Add List field in PDF file
            editor.AddField(Aspose.Pdf.Facades.FieldType.ListBox, "field2", 1, 300, 200, 350, 225);

            // Add list items
            editor.AddListItem("field2", "item 1");
            editor.AddListItem("field2", "item 2");

            // Add submit button
            editor.AddSubmitBtn("submitbutton", 1, "Submit Form", "http:// Testwebsite.com/testpage", 200, 200, 250, 225);

            // Delete list item
                editor.DelListItem("field2", "item 1");

            // Move field to new position
            editor.MoveField("field1", 10, 10, 50, 50);

            // Remove existing field from the PDF
            editor.RemoveField("field1");

            // Rename an existing field
            editor.RenameField("field1", "newfieldname");

            // Reset all visual attributes to empty value
            editor.ResetFacade();

            // Set the alignment style of a text field
            editor.SetFieldAlignment("field1", Aspose.Pdf.Facades.FormFieldFacade.AlignLeft);

            // Set appearance of the field
            editor.SetFieldAppearance("field1", Aspose.Pdf.Annotations.AnnotationFlags.NoRotate);

            // Set field attributes i.e. ReadOnly, Required
            editor.SetFieldAttribute("field1", Aspose.Pdf.Facades.PropertyFlag.ReadOnly);

            // Set field limit
            editor.SetFieldLimit("field1", 25);

            // Save modifications in the output file
            editor.Save(dataDir + "FormEditorFeatures2_out.pdf");                    
        }
    }
}