<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/java/repo/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-annotation</artifactId>
      <version>24.6</version>
   </dependency>
</dependencies>
copied!  
repositories {
    maven {
        url 'https://releases.groupdocs.com/java/repo/'
    }
}

compile(group: 'com.groupdocs', name: 'groupdocs-annotation', version: '24.6')
copied!  
<ivysettings>
    <settings defaultResolver="chain"/>
    <resolvers>
        <chain name="chain">
            <ibiblio name="GroupDocs Repository" m2compatible="true" root="https://releases.groupdocs.com/java/repo/"/>
        </chain>
    </resolvers>
</ivysettings>

<dependency org="com.groupdocs" name="groupdocs-annotation" rev="24.6">
   <artifact name="groupdocs-annotation" ext="jar"/>
</dependency>
copied!  
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))

libraryDependencies += "com.groupdocs" % "groupdocs-annotation" % "24.6"
copied!  

API de Código Alto de Anotador de Documentos Java

Produto Documentação Demonstrações Referência de API Exemplos Blog Suporte Licença

GroupDocs.Annotation para Java é uma robusta API local projetada para desenvolvedores Java anotarem, marcarem com marca d’água e gerenciarem documentos em vários formatos, como PDF, Word®, Excel®, PowerPoint® e imagens. Ele oferece recursos avançados, incluindo anotações de texto, área e imagem, suporte a OLE, gerenciamento de metadados e compatibilidade multiplataforma.

Funcionalidades da API Local de Anotação de Documentos Java

Suporte a Documentos e Formatos

  • Suporte a Múltiplos Formatos de Documento: Anote vários formatos de documento, incluindo PDF, Word®, Excel®, PowerPoint®, Visio® e imagens (JPG, PNG, BMP, etc.).
  • Anotações Específicas para PDF: Suporte para notas adesivas, campos de texto e outros tipos de anotações específicas para PDF.
  • Suporte a Formatos de Imagem: Anote formatos de imagem populares, incluindo JPG, PNG, BMP e mais.
  • Formatos de Exportação de Anotações: Exporte anotações em diferentes formatos para interoperabilidade.
  • Suporte a OLE: Suporte a objetos OLE dentro de documentos anotados.
  • Compatibilidade com Outras APIs do GroupDocs: Integração perfeita com outros produtos do GroupDocs para funcionalidades estendidas.

Tipos de Anotação e Ferramentas

  • Anotações de Texto: Adicione anotações de texto, como destaques, sublinhados e tachados.
  • Anotações de Área: Destaque e comente em áreas específicas usando anotações de retângulo, polígono e ponto.
  • Anotações de Marcação: Aplique anotações de marcação, como redação, para ocultar conteúdo sensível.
  • Medição de Distância: Meça distâncias dentro dos documentos, útil para desenhos técnicos e arquivos CAD.
  • Marca d’água: Adicione marcas d’água de texto e imagem para fins de marcação ou segurança.
  • Anotações de Imagem: Anote arquivos de imagem, com suporte para vários formatos de imagem.

Gestão de Anotações

  • Respostas às Anotações: Permita que vários usuários respondam às anotações, possibilitando revisões colaborativas de documentos.
  • Aparência Personalizada de Anotação: Personalize a aparência da anotação, incluindo configurações de cor, fonte e opacidade.
  • Exportar/Importar Anotações: Exporte anotações para arquivos externos e importe-as de volta para compartilhamento ou colaboração.
  • Camadas de Anotação: Controle as camadas de anotações, permitindo que se sobreponham ou permaneçam separadas.
  • Manipulação de Anotações: Capacidade de criar, editar e excluir anotações programaticamente.
  • Metadados de Anotação: Anote documentos enquanto preserva a integridade dos metadados.
  • Suporte a Desfazer/Refazer: Implemente a funcionalidade de desfazer/refazer para operações de anotação.

Colaboração e Revisão

  • Funcionalidades Colaborativas: Permita que vários usuários anotem, comentem e colaborem no mesmo documento.
  • Comparação de Documentos: Compare documentos ou imagens lado a lado para destacar diferenças.
  • Respostas às Anotações: Permita que vários usuários respondam às anotações, possibilitando revisões colaborativas de documentos.

Segurança e Integridade de Documentos

  • Segurança de Documentos: Aplique anotações que possam obscurecer informações sensíveis, como redações.
  • Gestão de Metadados: Gerencie e preserve metadados dentro dos documentos anotados.

Pesquisa e Navegação

  • Capacidades Avançadas de Pesquisa: Pesquise dentro de documentos anotados, incluindo a capacidade de pesquisar dentro das anotações.

Desempenho e Escalabilidade

  • Processamento em Lote: Manipule anotações em vários documentos ao mesmo tempo para maior eficiência.
  • Escalabilidade: Projetado para lidar com grandes volumes de documentos e anotações de forma eficiente.
  • Alto Desempenho: Otimizado para rápido processamento de anotações e manipulação de documentos.

Compatibilidade e Integração Multiplataforma

  • Compatibilidade Multiplataforma: Use em vários sistemas operacionais, incluindo Windows, macOS e Linux.
  • Integração Flexível: Integre facilmente em aplicativos Java com um rico conjunto de funcionalidades de API.

Saída e Apresentação

  • Impressão e Salvamento de Anotações: Inclua ou exclua anotações ao imprimir ou salvar documentos.

Formatos de Documentos Suportados

Para alguns tipos de arquivo, o GroupDocs.Annotation salva o resultado em um formato diferente. Neste caso, o tipo de arquivo de saída é especificado após *. Se nenhum símbolo desse tipo for especificado, o GroupDocs.Annotation salva o resultado no formato original do arquivo.

FormatoDescriçãoAnotar
DOCDocumento Microsoft Word® 97-2003
DOCXDocumento Microsoft Word®
DOCMDocumento Habilitado para Macros do Microsoft Word®
DOTModelo Microsoft Word® 97-2003
DOTXModelo Microsoft Word®
DOTMModelo Habilitado para Macros do Microsoft Word®
RTFDocumento de Texto Rico
ODTTexto OpenDocument
XLSPlanilha Microsoft Excel® 97-2003
XLSXPlanilha Microsoft Excel®
XLSM (*xlsx)Planilha Habilitada para Macros do Microsoft Excel®
XLSB (*xlsx)Planilha Binária do Microsoft Excel®
ODS (*xlsx)Planilha OpenDocument
PPTApresentação Microsoft PowerPoint® 97-2003
PPTXApresentação Microsoft PowerPoint®
PPSApresentação de Slides Microsoft PowerPoint® 97-2003
PPSX (*pptx)Apresentação de Slides Microsoft PowerPoint®
ODPApresentação OpenDocument
TIF, TIFFFormato de Arquivo de Imagem Marcada (TIFF)
JPG, JPEGGrupo de Especialistas Fotográficos Conjuntos (JPEG)
PNGGráficos de Rede Portáteis (PNG)
BMPImagem de Bitmap (BMP)
DWG (*png)Formatos de Dados de Design da Autodesk®
DXF (*png)Formato de Intercâmbio de Desenhos
PDF (PDF/A-1a,PDF/A-1b,PDF/A-2a)Formato de Documento Portátil Adobe (PDF)
HTM (*html)Linguagem de Marcação de Hipertexto (HTM)
HTMLLinguagem de Marcação de Hipertexto (HTML)
EMLMensagem de E-mail (EML)
EMLX (*eml)Mensagem de E-mail (EMLX)
VSD (*vsdx)Desenho Microsoft Visio® 2003-2010
VSDXDesenho Microsoft Visio®
VSDM (*vsdx)Formato de Arquivo de Desenho Microsoft Visio®
VSS (*vsdx)Estêncil Microsoft Visio® 2003-2010
VSSX (*vsdx)Formato de Arquivo de Estêncil Visio®
VST (*vsdx)Estêncil Microsoft Visio® 2013
VSTM (*vsdx)Formato de Arquivo de Modelo Microsoft Visio®

Tipos de Anotação Suportados

Anotações Gráficas

  • Área: Marca uma área com um retângulo e adiciona notas a ela.
  • Seta: Desenha uma seta em um documento.
  • Distância: Mede a distância entre objetos em um documento.
  • Elipse: Desenha uma anotação elíptica em um documento.
  • Ponto: Cola comentários em qualquer ponto de um documento.
  • Polilinha: Desenha formas e linhas à mão livre.
  • Redação: Preenche um retângulo preto com uma posição fixa (usado para ocultar texto).
  • Campo de Texto: Adiciona um retângulo com texto dentro.

Anotações de Texto

  • Destaque: Destaca e comenta o texto selecionado.
  • Substituição: Substitui o texto original pelo texto do usuário.
  • Riscado: Marca o texto com um estilo de tachado.
  • Sublinhado: Marca o texto com um estilo sublinhado.

Anotações de Marca d’água

  • Marca d’água Horizontal: Adiciona uma marca d’água de texto horizontal.
  • Marca d’água Diagonal: Adiciona uma marca d’água de texto diagonal.

Requisitos do Sistema

GroupDocs.Annotation para Java suporta os seguintes sistemas operacionais, frameworks e gerenciadores de pacotes:

Opções Suportadas
Sistemas OperacionaisMicrosoft Windows® Desktop
Microsoft Windows® Server
Linux
macOS
Frameworks SuportadosJava 7 (1.7) e superior
Ambientes de DesenvolvimentoNetBeans
IntelliJ IDEA
Eclipse
Ferramenta de Automação de BuildMaven

GroupDocs.Annotation para Java não requer nenhum software externo ou ferramenta de terceiros para ser instalado. Basta seguir uma das maneiras descritas em Instalação e Configuração.

Primeiros Passos

O GroupDocs hospeda todas as APIs Java no Repositório GroupDocs. Você pode usar facilmente a API GroupDocs.Annotation para Java diretamente em seus projetos Maven com configurações simples.

Etapa 1: Especificar a Configuração do Repositório GroupDocs

Para começar, você precisa especificar a configuração do repositório GroupDocs em seu arquivo Maven pom.xml como segue:

<repositories>
    <repository>
        <id>Repositório de Artefatos GroupDocs</id>
        <name>Repositório de Artefatos GroupDocs</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>

Etapa 2: Definir a Dependência da API GroupDocs.Annotation para Java

Em seguida, defina a dependência da API GroupDocs.Annotation para Java em seu arquivo pom.xml como segue:

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-annotation</artifactId>
        <version>23.10</version> 
    </dependency>
</dependencies>

Exemplos de Código

Exemplo de Código 1: Adicionando uma Anotação de Texto a um Documento PDF

Este trecho de código demonstra como usar o GroupDocs.Annotation para Java para adicionar uma anotação de texto a um documento PDF. A anotação de texto inclui um comentário ou nota que aparece como um pop-up quando o usuário passa o mouse sobre a área anotada. Este recurso é particularmente útil para revisar e comentar documentos PDF.

// Importar classes necessárias
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.Annotation;
import com.groupdocs.annotation.models.annotationtypes.TextAnnotation;
import com.groupdocs.annotation.options.export.AnnotationOptions;

import java.awt.Color;
import java.nio.file.Paths;

public class AddTextAnnotationToPDF {
    public static void main(String[] args) {
        // Caminho para o documento PDF de entrada
        String inputFilePath = "input.pdf";
        
        // Caminho para o documento PDF de saída
        String outputFilePath = "output.pdf";
        
        // Inicializar o objeto Annot

ator para o documento PDF
        Annotator annotator = new Annotator(inputFilePath);
        
        // Criar uma nova anotação de texto
        TextAnnotation textAnnotation = new TextAnnotation();
        textAnnotation.setPageNumber(1); // Definir número da página
        textAnnotation.setMessage("Esta é uma anotação de texto"); // Definir mensagem de anotação
        textAnnotation.setBox(new Rectangle(100, 100, 200, 50)); // Definir posição e tamanho da anotação
        textAnnotation.setBackgroundColor(Color.yellow); // Definir cor de fundo da anotação
        textAnnotation.setFontColor(Color.black); // Definir cor da fonte para o texto da anotação
        
        // Adicionar a anotação de texto ao documento
        annotator.add(textAnnotation);
        
        // Salvar o documento PDF anotado
        annotator.save(outputFilePath, new AnnotationOptions());
        
        // Fechar o annotator
        annotator.dispose();
        
        System.out.println("Anotação de texto adicionada com sucesso ao documento PDF.");
    }
}

Exemplo de Código 2: Removendo Anotações de um Documento Word

Este trecho de código ilustra como remover todas as anotações de um documento Microsoft Word (DOCX) usando o GroupDocs.Annotation para Java. Isso é especialmente útil quando você precisa limpar um documento removendo comentários, notas ou outros tipos de anotações.

// Importar classes necessárias
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.options.remove.RemoveOptions;

public class RemoveAnnotationsFromWordDocument {
    public static void main(String[] args) {
        // Caminho para o documento Word de entrada
        String inputFilePath = "input.docx";
        
        // Caminho para o documento Word de saída
        String outputFilePath = "output.docx";
        
        // Inicializar o objeto Annotator para o documento Word
        Annotator annotator = new Annotator(inputFilePath);
        
        // Definir opções de remoção para remover todas as anotações
        RemoveOptions removeOptions = new RemoveOptions();
        
        // Remover todas as anotações do documento
        annotator.remove(removeOptions);
        
        // Salvar o documento Word limpo
        annotator.save(outputFilePath);
        
        // Fechar o annotator
        annotator.dispose();
        
        System.out.println("Todas as anotações removidas com sucesso do documento Word.");
    }
}

Exemplo de Código 3: Extraindo Comentários de uma Planilha Excel

Este trecho de código mostra como extrair comentários e anotações de uma planilha Excel (XLSX) usando o GroupDocs.Annotation para Java. Este recurso é benéfico para revisar e resumir feedback ou notas deixadas em um documento Excel.

// Importar classes necessárias
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.AnnotationBase;
import com.groupdocs.annotation.options.export.AnnotationOptions;

import java.util.List;

public class ExtractCommentsFromExcel {
    public static void main(String[] args) {
        // Caminho para o documento Excel de entrada
        String inputFilePath = "input.xlsx";
        
        // Inicializar o objeto Annotator para o documento Excel
        Annotator annotator = new Annotator(inputFilePath);
        
        // Extrair todas as anotações do documento
        List<AnnotationBase> annotations = annotator.get();
        
        // Iterar pelas anotações extraídas e imprimir suas mensagens
        for (AnnotationBase annotation : annotations) {
            System.out.println("Tipo de Anotação: " + annotation.getAnnotationType());
            System.out.println("Mensagem da Anotação: " + annotation.getMessage());
        }
        
        // Fechar o annotator
        annotator.dispose();
        
        System.out.println("Comentários extraídos com sucesso da planilha Excel.");
    }
}

Produto Documentação Demonstrações Referência de API Exemplos Blog Suporte Licença

VersionRelease Date
24.630 de junho de 2024
23.109 de outubro de 2023
23.828 de agosto de 2023
23.623 de junho de 2023
23.417 de abril de 2023
23.216 de abril de 2023
21.7.225 de janeiro de 2022
21.7.125 de janeiro de 2022
2.0.025 de janeiro de 2022
19.225 de janeiro de 2022
17.1025 de janeiro de 2022
17.10.325 de janeiro de 2022
1.5.025 de janeiro de 2022
21.721 de julho de 2021
19.719 de fevereiro de 2020
20.213 de fevereiro de 2020
19.530 de maio de 2019
19.415 de abril de 2019
18.116 de outubro de 2018
18.1016 de outubro de 2018
1.4.018 de abril de 2018
1.6.018 de abril de 2018
1.7.018 de abril de 2018
1.7.118 de abril de 2018
1.8.018 de abril de 2018
1.8.118 de abril de 2018
1.8.218 de abril de 2018
1.9.018 de abril de 2018
17.1.018 de abril de 2018
17.10.118 de abril de 2018
17.10.218 de abril de 2018
17.5.018 de abril de 2018
17.6.018 de abril de 2018
18.418 de abril de 2018
3.1.018 de abril de 2018