Sobre GroupDocs.Annotation for Net API

GroupDocs.Annotation for Net API é uma biblioteca que permite adicionar anotações a PDF, Word e outros documentos no Mac, Windows ou Ubuntu. GroupDocs.Annotation for Net é uma API de rede nativa para gerenciar anotações com suporte abrangente para criar, adicionar, editar, excluir, extrair e exportar anotações de imagens e vários outros documentos. A lista completa de formatos de documentos suportados pode ser vista nesta página. Esta biblioteca permite que você trabalhe não apenas com documento DOCX, mas também com muitos outros tipos de documentos, como Word, Excel, PowerPoint, e-mails do Outlook, Visio, Adobe, OpenDocument, OpenOffice, Photoshop, AutoCad e muitos outros. O GroupDocs.Annotation for Net API permite criar e adicionar novas notas, editar anotações, extrair comentários, anotações e removê-los de documentos. A biblioteca suporta 13 tipos diferentes de anotação, incluindo Texto, Polilinha, Área, Sublinhado, Ponto, Marca d’água, Seta, Elipse, Substituição de Texto, Distância, Campo de Texto, Redação de Recursos em PDF, HTML, documentos do Microsoft Word, planilhas, diagramas, apresentações, desenhos, imagens e muitos outros formatos de arquivo. O exemplo (veja abaixo) demonstra como trabalhar com o documento DOCX, neste exemplo você pode ver as principais etapas de como trabalhar com GroupDocs.Annotation: Configurar uma licença, abrir um documento com o qual deseja trabalhar, criar um anotação, adicionando objetos de dados para definir as propriedades de anotação de acordo com seus requisitos e salvando o resultado no local necessário. Além disso, você pode dar uma olhada mais detalhada nos recursos suportados em nossa página do github ou em nossa documentação do produto.

Etapas para adicionar anotações a DOCX na rede

GroupDocs.Annotation facilita para os desenvolvedores da rede adicionar vários tipos de anotação a arquivos DOCX em qualquer aplicativo baseado na rede, implementando algumas etapas fáceis.

  • Crie objetos Reply com comentário e data.
  • Crie um objeto AreaAnnotation, defina opções de área e adicione respostas.
  • Crie o objeto Anotador e adicione a anotação de área.
  • Salve o arquivo de saída.

Requisitos de sistema

GroupDocs.Annotation for Net APIs são suportados em todas as principais plataformas e sistemas operacionais. Antes de executar o código abaixo, certifique-se de ter os seguintes pré-requisitos instalados em seu sistema.

  • Sistemas Operacionais: Microsoft Windows, Linux, MacOS
  • Ambientes de desenvolvimento: Visual Studio, Xamarin, MonoDevelop
  • Estruturas: .NET Framework, .NET Standard, .NET Core, Mono
  • Baixe a versão mais recente do GroupDocs.Annotation para .NET de NuGet

Visualização de anotação e amostra de código

//Add text field annotation to the document from local disk
using (Annotator annotator = new Annotator("input.bmp"))
{
    TextFieldAnnotation textField = new TextFieldAnnotation
    {
        BackgroundColor = 65535,
        Box = new Rectangle(100, 100, 100, 100),
        CreatedOn = DateTime.Now,
        Text = "Some text",
        FontColor = 65535,
        FontSize = 12,
        Message = "This is text field annotation",
        Opacity = 0.7,
        PageNumber = 0,
        PenStyle = PenStyle.Dot,
        PenWidth = 3,
        FontFamily = "Arial",
        TextHorizontalAlignment = HorizontalAlignment.Center,
        Replies = new List
        {
            new Reply
            {
                Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(textField);
    annotator.Save("result.bmp");
}

Annotation preview image

Etapas para remover anotações de DOCX na rede

GroupDocs.Annotation torna mais fácil para os desenvolvedores da rede remover detalhes de anotação de arquivos DOCX dentro de qualquer aplicativo baseado na rede, implementando algumas etapas fáceis.

  • Crie objetos Reply com comentário e data.
  • Instancie o objeto SaveOptions e defina AnnotationTypes = AnnotationType.None.
  • Chame o método save com o caminho ou fluxo do documento resultante e o objeto SaveOptions.

// 1- How to remove annotation from document using annotation index

using (Annotator annotator = new Annotator("result.bmp"))
{
    annotator.Remove(0);
    annotator.Save("removed.bmp");
}

// 2- How to remove annotation from document using annotation object

using (Annotator annotator = new Annotator("result.bmp"))
{
    var tmp = annotator.Get();
    annotator.Remove(tmp[0]);
    annotator.Save("removed.bmp");
}

// 3- How to remove some annotations from document using list of ID’s

using (Annotator annotator = new Annotator("result.bmp"))
{
    var idList = new List{1, 2, 3};
    annotator.Remove(idList);
    annotator.Save("removed.bmp");
}

// 4- How to remove some annotations from document using list of annotations

using (Annotator annotator = new Annotator("result.bmp"))
{
    var tmp = annotator.Get();
    annotator.Remove(tmp);
    annotator.Save("removed.bmp");
}

Etapas para editar anotações de DOCX na rede

GroupDocs.Annotation torna mais fácil para os desenvolvedores da rede atualizar várias propriedades de anotação de arquivos DOCX dentro de qualquer aplicativo baseado na rede, implementando algumas etapas fáceis.

  • Instanciar objeto Anotador com caminho de documento de entrada ou fluxo com LoadOptions instanciado com ImportAnnotations = true.
  • Crie alguma implementação AnnotationBase e defina o Id da anotação existente (se a anotação com esse Id não for encontrada, nada será alterado) ou a lista de caminhos das anotações (todas as anotações existentes serão removidas).
  • Chame o método de atualização do objeto Anotador com as anotações passadas.
  • Chame o método save com o caminho ou fluxo do documento resultante e o objeto SaveOptions.

// open annotated document
using (Annotator annotator = new Annotator("result.bmp"))
{
    //assuming we are going to change some properties of existing annotation
        AreaAnnotation updated = new AreaAnnotation
            {
                    // It's important to set existed annotation Id
                    Id = 1,
                    BackgroundColor = 255,
                    Box = new Rectangle(0, 0, 50, 200),
                    CreatedOn = DateTime.Now,
                    Message = "This is updated annotation",
                    Replies = new List
                    {
                        new Reply
                        {
                            Comment = "Updated first comment",
                            RepliedOn = DateTime.Now
                        },
                        new Reply
                        {
                            Comment = "Updated second comment",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
        // update annotation
        annotator.Update(updated);
        annotator.Save("result.bmp");
}

Etapas para extrair anotações de DOCX na rede

GroupDocs.Annotation torna mais fácil para os desenvolvedores da rede anotar documentos e extrair informações de anotação de arquivos DOCX em qualquer aplicativo baseado na rede, implementando algumas etapas fáceis.

  • Crie objetos Reply com comentário e data.
  • Instancie o objeto LoadOptions e chame SetImportAnnotations com o argumento true.
  • Defina a variável com o tipo Lista.
  • Chame o método get e retorne o resultado para a variável acima.

// for using this example input file ("annotated.bmp") must be with annotations
using (Annotator annotator = new Annotator("annotated.bmp"))
{
    List annotations = annotator.Get();
    XmlSerializer formatter = new XmlSerializer(typeof(List));
    using (FileStream fs = new FileStream("annotations.xml", FileMode.Create))
    {
        fs.SetLength(0);
        formatter.Serialize(fs, annotations);
    }
}

Demonstrações ao vivo para adicionar, remover, editar e extrair anotações em documentos e imagens

Adicione, remova, edite e extraia anotações para o arquivo DOCX agora mesmo visitando o site GroupDocs.Annotation Live Demos. A demonstração ao vivo tem os seguintes benefícios

não há necessidade de baixar API

não é necessário escrever nenhum código

basta carregar o ficheiro de origem

Obter link de download para salvar o arquivo

Sobre o formato de arquivo DOCX

DOCX é um formato bem conhecido para documentos do Microsoft Word. Introduzido a partir de 2007 com o lançamento do Microsoft Office 2007, a estrutura desse novo formato de documento foi alterada de binário simples para uma combinação de arquivos XML e binários. Os arquivos Docx podem ser abertos com o Word 2007 e versões laterais, mas não com as versões anteriores do MS Word que suportam extensões de arquivo DOC.

leia mais Sobre o formato de arquivo DOCX

Trabalhando com outros formatos de documento populares

Atualize as propriedades de anotação de alguns dos formatos de arquivo populares, conforme indicado abaixo.

Annotate PDF document

(Adobe Portable Document Format)

Annotate DOC document

(Microsoft Word Document)

Annotate DOCM document

(Microsoft Word Macro-Enabled Document)

Annotate DOCX document

(Microsoft Word Open XML Document)

Annotate DOT document

(Microsoft Word Document Template)

Annotate DOTX document

(Word Open XML Document Template)

Annotate RTF document

(Rich Text Document)

Annotate ODT document

(Open Document Text)

Annotate XLS document

(Microsoft Excel Binary File Format)

Annotate XLSX document

(Microsoft Excel Open XML Spreadsheet)

Annotate XLSM document

(Microsoft Excel Macro-Enabled Spreadsheet)

Annotate XLSB document

(Microsoft Excel Binary Worksheet)

Annotate ODS document

(Open Document Spreadsheet)

Annotate PPT document

(PowerPoint Presentation)

Annotate PPTX document

(PowerPoint Open XML Presentation)

Annotate PPSX document

(PowerPoint Open XML Slide Show)

Annotate POTM document

(Microsoft PowerPoint Template)

Annotate PPTM document

(Microsoft PowerPoint Presentation)

Annotate PPS document

(Microsoft PowerPoint 97-2003 Slide Show)

Annotate ODP document

(OpenDocument Presentation)

Annotate HTML document

(HyperText Markup Language)

Annotate TIFF document

(Tagged Image File Format)

Annotate PNG document

(Portable Network Graphic)

Annotate EML document

(E-mail Message)

Annotate MSG document

(Microsoft Outlook E-mail Message)

Annotate VSD document

(Microsoft Visio 2003-2010 Drawing)

Annotate VSDX document

(Microsoft Visio Drawing)

Annotate VSS document

(Microsoft Visio 2003-2010 Stencil)

Annotate VST document

(Microsoft Visio 2013 Stencil)

Annotate DWG document

(Autodesk Design Data Formats)

Annotate DXF document

(AutoCAD Drawing Interchange)

Annotate DCM document

(Digital Imaging and Communications in Medicine)

Annotate WMF document

(Windows Metafile)

Annotate EMF document

(Enhanced Metafile Format)

Back to top
 Português