<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>
repositories {
maven {
url 'https://releases.groupdocs.com/java/repo/'
}
}
compile(group: 'com.groupdocs', name: 'groupdocs-annotation', version: '24.6')
<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>
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))
libraryDependencies += "com.groupdocs" % "groupdocs-annotation" % "24.6"
API de Código Alto de Anotador de Documentos Java
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.
Formato | Descrição | Anotar |
---|---|---|
DOC | Documento Microsoft Word® 97-2003 | ✔ |
DOCX | Documento Microsoft Word® | ✔ |
DOCM | Documento Habilitado para Macros do Microsoft Word® | ✔ |
DOT | Modelo Microsoft Word® 97-2003 | ✔ |
DOTX | Modelo Microsoft Word® | ✔ |
DOTM | Modelo Habilitado para Macros do Microsoft Word® | ✔ |
RTF | Documento de Texto Rico | ✔ |
ODT | Texto OpenDocument | ✔ |
XLS | Planilha Microsoft Excel® 97-2003 | ✔ |
XLSX | Planilha Microsoft Excel® | ✔ |
XLSM (*xlsx) | Planilha Habilitada para Macros do Microsoft Excel® | ✔ |
XLSB (*xlsx) | Planilha Binária do Microsoft Excel® | ✔ |
ODS (*xlsx) | Planilha OpenDocument | ✔ |
PPT | Apresentação Microsoft PowerPoint® 97-2003 | ✔ |
PPTX | Apresentação Microsoft PowerPoint® | ✔ |
PPS | Apresentação de Slides Microsoft PowerPoint® 97-2003 | ✔ |
PPSX (*pptx) | Apresentação de Slides Microsoft PowerPoint® | ✔ |
ODP | Apresentação OpenDocument | ✔ |
TIF, TIFF | Formato de Arquivo de Imagem Marcada (TIFF) | ✔ |
JPG, JPEG | Grupo de Especialistas Fotográficos Conjuntos (JPEG) | ✔ |
PNG | Gráficos de Rede Portáteis (PNG) | ✔ |
BMP | Imagem 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) | ✔ |
HTML | Linguagem de Marcação de Hipertexto (HTML) | ✔ |
EML | Mensagem de E-mail (EML) | ✔ |
EMLX (*eml) | Mensagem de E-mail (EMLX) | ✔ |
VSD (*vsdx) | Desenho Microsoft Visio® 2003-2010 | ✔ |
VSDX | Desenho 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 Operacionais | Microsoft Windows® Desktop |
Microsoft Windows® Server | |
Linux | |
macOS | |
Frameworks Suportados | Java 7 (1.7) e superior |
Ambientes de Desenvolvimento | NetBeans |
IntelliJ IDEA | |
Eclipse | |
Ferramenta de Automação de Build | Maven |
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.");
}
}
Version | Release Date |
---|---|
24.6 | 30 de junho de 2024 |
23.10 | 9 de outubro de 2023 |
23.8 | 28 de agosto de 2023 |
23.6 | 23 de junho de 2023 |
23.4 | 17 de abril de 2023 |
23.2 | 16 de abril de 2023 |
21.7.2 | 25 de janeiro de 2022 |
21.7.1 | 25 de janeiro de 2022 |
2.0.0 | 25 de janeiro de 2022 |
19.2 | 25 de janeiro de 2022 |
17.10 | 25 de janeiro de 2022 |
17.10.3 | 25 de janeiro de 2022 |
1.5.0 | 25 de janeiro de 2022 |
21.7 | 21 de julho de 2021 |
19.7 | 19 de fevereiro de 2020 |
20.2 | 13 de fevereiro de 2020 |
19.5 | 30 de maio de 2019 |
19.4 | 15 de abril de 2019 |
18.1 | 16 de outubro de 2018 |
18.10 | 16 de outubro de 2018 |
1.4.0 | 18 de abril de 2018 |
1.6.0 | 18 de abril de 2018 |
1.7.0 | 18 de abril de 2018 |
1.7.1 | 18 de abril de 2018 |
1.8.0 | 18 de abril de 2018 |
1.8.1 | 18 de abril de 2018 |
1.8.2 | 18 de abril de 2018 |
1.9.0 | 18 de abril de 2018 |
17.1.0 | 18 de abril de 2018 |
17.10.1 | 18 de abril de 2018 |
17.10.2 | 18 de abril de 2018 |
17.5.0 | 18 de abril de 2018 |
17.6.0 | 18 de abril de 2018 |
18.4 | 18 de abril de 2018 |
3.1.0 | 18 de abril de 2018 |
GroupDocs.Annotation API Java Anotação de Documentos Marcação d'água Gestão de Documentos Anotação PDF Anotação Word Anotação Excel Anotação PowerPoint Anotação de Imagem Suporte OLE Gestão de Metadados Compatibilidade Multiplataforma Anotações de Texto Anotações de Área Anotações de Marcação Medição de Distância Redação Aparência Personalizada de Anotação Revisão Colaborativa de Documentos Segurança de Documentos Preservação de Metadados Processamento em Lote Alto Desempenho Escalabilidade Multiplataforma Impressão de Anotações Microsoft Word Microsoft Excel Microsoft PowerPoint PDF JPG PNG BMP DWG DXF Visio Adobe Portable Document Format Linguagem de Marcação de Hipertexto Mensagem de E-mail Ferramentas de Anotação Java Maven Integração API API Local Comparação de Documentos Integridade de Documentos