Explorando recursos da classe FormEditor

Documentos PDF às vezes contêm formulários interativos, que são conhecidos como AcroForm. É como um formulário usado em páginas da web. Esses formulários contêm diferentes tipos de controles, ou seja, caixas de texto, caixas de seleção e botões, etc. Um desenvolvedor que trabalha com arquivos PDF pode, às vezes, precisar editar esses formulários. Neste artigo, vamos analisar os detalhes de como o namespace Aspose.Pdf.Facades nos permite fazer isso.

Detalhes da implementação

Os desenvolvedores podem usar o namespace Aspose.Pdf.Facades não apenas para adicionar novos formulários e campos de formulário em um documento PDF, mas também para editar campos existentes. O escopo deste artigo é limitado aos recursos de Aspose.PDF for .NET que lidam com a edição de formulários.

FormEditor é a classe que contém a maioria dos métodos e propriedades que permitem aos desenvolvedores editar campos de formulário. Você pode não apenas adicionar novos campos, mas também remover campos existentes, mover um campo para outra posição, alterar o nome do campo ou atributos, etc. A lista de recursos fornecidos por esta classe é bastante abrangente, e é muito fácil trabalhar com os campos de formulário usando esta classe.

Esses métodos podem ser divididos em duas categorias principais, uma das quais é usada para manipular os campos, e a outra é usada para definir os novos atributos desses campos. Os métodos que podemos agrupar na primeira categoria incluem AddField, AddListItem, RemoveListItem, CopyInnerField, CopyOuterField, DelListItem, MoveField, RemoveField e RenameField, etc. Na segunda categoria de métodos, podem ser incluídos SetFieldAlignment, SetFieldAppearance, SetFieldAttribute, SetFieldLimit, SetFieldScript. O seguinte trecho de código mostra alguns dos métodos da 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");                    
        }
    }
}