Chega de longas discussões em longos tópicos de e-mail sobre o conteúdo do(s) documento(s). Você pode usar anotações para marcar documentos com mensagens personalizadas e suas respostas. Este artigo discute como anotar arquivos PDF programaticamente em documentos de marcação usando C#. Além disso, também discutiremos como remover anotações de arquivos PDF.

Os seguintes tópicos são discutidos brevemente abaixo:

API .NET para anotar arquivos PDF

GroupDocs.Annotation tem sua API .NET para trabalhar com as anotações dentro dos documentos e imagens. Ele permite adicionar, remover e extrair anotações de documentos PDF e Word, planilhas e apresentações. Além disso, ele suporta imagens, páginas da Web, mensagens de e-mail, desenhos do Visio e muito mais. Você pode dar uma olhada na documentação para obter a lista completa de formatos de documento suportados para anotação.

Baixe o instalador de DLLs ou MSI na seção de downloads ou instale a API em seu aplicativo .NET via NuGet. Você também pode usar o seguinte comando do Gerenciador de Pacotes.

PM> Install-Package GroupDocs.Annotation

Adicionar anotações ao PDF usando C#

Existem muitos tipos diferentes de anotações disponíveis para adicionar nos documentos, no entanto, discutiremos apenas algumas neste artigo.

Anotações adicionadas ao PDF

A seguir estão algumas das anotações suportadas. Você pode saber sobre cada anotação individualmente.

Adicionar anotação de seta ao PDF usando C#

A seguir estão as etapas de como adicionar anotações de seta a documentos PDF em C#.

Adicionar anotação de seta programaticamente em Java e C# .NET
  • Carregue o documento PDF usando a classe Annotator.
  • Inicialize a Anotação de seta.
  • Defina a posição, tamanho, número de página da anotação de seta.
  • Adicione a anotação de seta definida usando o método Add.
  • Salve o documento anotado usando o método apropriado Save().

O exemplo de código C# a seguir mostra como adicionar uma anotação de seta a um documento PDF.

// Adicionar anotação de seta a documentos PDF usando C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
    ArrowAnnotation arrow = new ArrowAnnotation
    {
        Box = new Rectangle(100, 100, 50, 50),

        // opcional --
        CreatedOn = DateTime.Now,
        Message = "Your Message",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -3407872,
        PenStyle = PenStyle.Solid,
        PenWidth = 2
    };
    annotator.Add(arrow);
    annotator.Save("path/annotation.pdf");
}

Inserir anotação de retângulo ou área em PDF usando C#

A seguir estão as etapas para adicionar um retângulo ou anotação de área a um documento PDF com algumas personalizações. É muito semelhante a adicionar anotações de seta, mas usa AreaAnnotation.

  • Carregue o documento PDF usando a classe Annotator.
  • Inicialize a anotação do retângulo usando a classe AreaAnnotation.
  • Especifique a posição, tamanho e cor do retângulo.
  • Você também pode definir outras propriedades, como número da página, plano de fundo, opacidade, estilo, largura da caneta, mensagens e hora.
  • Adicione a anotação do retângulo definido ao Anotador.
  • Por fim, salve o arquivo anotado usando o método Save().
Adicionar anotação de retângulo ou área programaticamente em C# .NET e Java

O exemplo de código a seguir adiciona anotação de retângulo/área a um documento PDF usando C#.

// Adicionar anotação de área ou retângulo em documentos PDF usando C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
    AreaAnnotation area = new AreaAnnotation
    {
        BackgroundColor = 65535,
        Box = new Rectangle(80, 75, 450, 135),
        Message = "This is area annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -131,
        PenStyle = PenStyle.Dash,
        PenWidth = 3
    };
    annotator.Add(area);
    annotator.Save("path/annotation.pdf");
}

Adicionar anotação oval ou elipse ao PDF usando C#

Da mesma forma, vamos adicionar a anotação elipse/oval. As etapas a seguir mostram como uma anotação oval ou elipse pode ser adicionada a um arquivo PDF usando C#.

Adicionar elipses ou anotação oval programaticamente em C# .NET e Java
  • Carregue o arquivo PDF usando a classe Annotator.
  • Inicialize a Elipse Annotation.
  • Defina a posição, tamanho e outras propriedades da anotação inicializada.
  • Adicione a anotação de elipse criada ao objeto Annotator.
  • Use o método Save() para salvar o arquivo PDF anotado.

O exemplo de código C# a seguir adiciona uma anotação oval/elipse a um documento PDF.

// Adicionar anotação oval ou elipse em documentos PDF usando C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
    EllipseAnnotation ellipse = new EllipseAnnotation
    {
        BackgroundColor = -16034924,
        Box = new Rectangle(275, 475, 300, 80),
        Message = "This is ellipse annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -16034924,
        PenStyle = PenStyle.Dot,
        PenWidth = 3
    };
    annotator.Add(ellipse);
    annotator.Save("path/annotation.pdf");
}

Inserir anotação de distância em PDF usando C

Você pode usar a anotação de distância para apontar a distância entre dois objetos. A seguir estão as etapas que adicionam anotação de distância ao documento PDF usando C#.

Adicionar anotação de distância programaticamente em C# .NET e Java
  • Após carregar o documento PDF usando a classe Annotator, inicialize a anotação de distância usando [DistanceAnnotation](https://apireference.groupdocs. com/annotation/net/groupdocs.annotation.models.annotationmodels/distanceannotation).
  • Defina a aparência, cor da linha, espessura, estilo, etc.
  • Adicione a anotação de distância ao Anotador.
  • Salve o arquivo PDF com a anotação usando o método apropriado Save().

O trecho de código a seguir mostra como adicionar a anotação de distância no PDF usando C#.

// Adicionar anotação de distância a documentos PDF usando C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
    DistanceAnnotation distance = new DistanceAnnotation
    {
        Box = new Rectangle(750, 235, 0, 150),
        Message = "This is the heading area",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -21197,
        PenStyle = PenStyle.Solid,
        PenWidth = 3
    };
    annotator.Add(distance);
    annotator.Save("path/annotation.pdf");
}

Remover anotações de arquivos PDF usando C#

Existem diferentes maneiras de remover anotações de documentos PDF. Ou você pode remover todas as anotações de uma vez ou pode fornecer IDs, índices para remover as seletivas. Discutimos as diferentes maneiras de remover anotações no artigo separado. No entanto, aqui estão as etapas para remover todas as anotações de um arquivo PDF.

  • Carregue o documento.
  • Inicialize as Opções de Salvamento.
  • Defina os tipos de anotação como Nenhum.
  • Salve o arquivo PDF sem anotações usando o método Save().

O código C# a seguir mostra como remover anotações de arquivos PDF.

// Remova todas as anotações do documento PDF usando C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
    annotator.Save("path/document-noAnnotation.pdf", new SaveOptions {AnnotationTypes = AnnotationType.None});
}

Conclusão

Para concluir, você aprendeu como adicionar diferentes anotações a documentos PDF nos aplicativos .NET usando C#. Mais precisamente, adicionamos anotações de seta, elipse, área e distância. Além disso, você também viu uma das maneiras de remover todas as anotações de qualquer arquivo PDF.

Você pode pensar em construir seu próprio aplicativo .NET anotador de documentos. Para saber mais sobre o GroupDocs.Annotation for .NET, visite a documentação e o [GitHub](https://github.com/ groupdocs-annotation) repositório. Para mais dúvidas, entre em contato com o suporte no fórum.

Veja também