API do Word for .NET (Como funciona para desenvolvedores)

Estrutura do Documento

Ler e Editar Word: Com o IronWord, você pode extrair informações específicas de seus documentos Word, como extrair texto para edição ou reutilização e recuperar imagens que possam precisar ser usadas em outro lugar. Essa capacidade é vital para aplicações que visam unir documentos Word e processar as informações contidas em arquivos DOCX existentes.

Múltiplos Formatos: O IronWord suporta uma ampla gama de formatos de arquivo, aumentando sua utilidade na conversão de documentos Word em aplicações .NET.

Editar Configuração de Página: Personalizar o layout físico de seus documentos Word é simples com o IronWord. Você pode ajustar o tamanho do papel para vários arquivos MS Word para dimensões padrão ou personalizadas, mudar a orientação para diferentes seções de seu documento, definir as margens para garantir um alinhamento adequado e até mesmo modificar a cor de fundo para fins estéticos ou para destacar seções.

Adicionar Parágrafos: O IronWord permite a adição e remoção de execuções de texto dentro dos parágrafos, o que é essencial para editar e formatar grandes seções de texto. Além disso, você pode aprimorar seus parágrafos inserindo imagens e formas diretamente no texto, ajustando o estilo para corresponder às suas especificações de design, e definindo alinhamentos para um visual refinado. A capacidade de adicionar listas com marcadores e numerações também ajuda a organizar o conteúdo de forma mais eficaz.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();

        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));

        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));

        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));

        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();

        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));

        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));

        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));

        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

Adicionar Tabelas: Tabelas são um componente crítico dos arquivos DOCX e são facilmente manipuladas com o IronWord, apoiando a geração dinâmica de documentos. Você pode adicionar ou remover linhas e colunas, uma operação que é fundamental para a geração dinâmica de documentos onde a quantidade de dados pode variar. Juntar e dividir células dá a você a versatilidade de formatar tabelas complexas, e personalizar bordas e dimensões de layout permite uma aparência refinada e profissional.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));

        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };

        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };

        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);

        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));

        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };

        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };

        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);

        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

Elementos do Documento

Adicionar Execuções de Texto: Este recurso foca no controle preciso sobre o conteúdo do texto. Você pode adicionar, anexar e dividir execuções de texto, o que é vital para a criação dinâmica de documentos. As opções de estilo são extensas, incluindo a alteração de famílias de fontes, tamanhos e cores, além de adicionar negrito, itálico e outras decorações de texto. Você também pode incorporar imagens dentro das execuções de texto, criando um documento rico e visualmente atraente.

Adicionar Imagens: IronWord permite uma manipulação abrangente de imagens em Documentos Word. Você pode carregar imagens de várias fontes, ajustar o texto ao redor delas perfeitamente, e ajustar suas dimensões para caber no seu layout. A capacidade de definir o deslocamento de posição e a distância dos cantos do documento garante que suas imagens estarão sempre perfeitamente posicionadas.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();

        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };

        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);

        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();

        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };

        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);

        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

Adicionar Formas: As formas podem adicionar um impacto visual significativo a um documento, e IronWord oferece as ferramentas para inseri-las e personalizá-las com precisão. Você pode definir o tipo de forma (como retângulos, círculos, setas, etc.), determinar como o texto deve se ajustar em torno da forma, especificar dimensões e posicionamento exatos, e até mesmo girar formas para alcançar o efeito visual desejado.

Versões .NET & Tipos de Projetos

IronWord é projetado para ampla compatibilidade dentro do ecossistema .NET, suportando C#, VB.NET e F# em várias versões do .NET, incluindo .NET Core, .NET Standard e .NET Framework. Isso garante sua utilidade em aplicações contemporâneas e legadas. A versatilidade da biblioteca se estende a tipos de projeto, acomodando aplicativos web, móveis e de desktop através da integração com Blazor, WebForms, Xamarin, MAUI, WPF e aplicativos de console.

Ambientes de aplicativos

Em termos de ambientes de aplicação, IronWord é adaptável às plataformas Windows, Linux, iOS, e Android, incluindo suporte específico para conteinerização e implantação na nuvem no Docker, Azure, e AWS. Este suporte abrangente facilita o desenvolvimento em diferentes ambientes.

Sistemas Operacionais & IDEs

IronWord também é compatível com os principais Ambientes de Desenvolvimento Integrado (IDEs), como Microsoft Visual Studio, ReSharper e Rider, oferecendo aos desenvolvedores flexibilidade na escolha de suas ferramentas. Por último, oferece suporte a vários sistemas operacionais e arquiteturas de processador (x64, x86, ARM), garantindo desempenho eficiente em diversas configurações de hardware.

Licença Lite

Esta opção é adaptada para desenvolvedores individuais trabalhando sozinhos em um projeto. O preço é $799 e cobre um desenvolvedor em uma única localização.

Licença Plus

Destinada a pequenas equipes, esta licença, por $plusLicense, acomoda até três desenvolvedores e é aplicável para uso em três locais em três projetos.

Licença Professional

Para equipes maiores, a Licença Professional é precificada em $professionalLicense e suporta até dez desenvolvedores. Ela é projetada para atender operações mais substanciais e inclui recursos de suporte premium.