Sobre GroupDocs.Annotation para API Java

GroupDocs.Annotation for Java API é uma biblioteca que permite adicionar anotações a PDF, Word e outros documentos no Mac, Windows ou Ubuntu. GroupDocs.Annotation for Java é uma API Java 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 DOTX, 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. A API GroupDocs.Annotation for Java 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 DOTX, 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 DOTX em Java

GroupDocs.Annotation facilita para os desenvolvedores Java adicionar vários tipos de anotação a arquivos DOTX em qualquer aplicativo baseado em Java, 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 para APIs Java 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
Ambiente de Desenvolvimento: NetBeans, Intellij IDEA, Eclipse etc.
Java Runtime Environment: Java 7 (1.7) e superior
Obtenha a versão mais recente do GroupDocs.Annotation for Java no GroupDocs Artifact Repository

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

// Create an instance of Reply class and add comments
Reply firstReply = new Reply();
firstReply.setComment("First comment");
firstReply.setRepliedOn(Calendar.getInstance().getTime());

Reply secondReply = new Reply();
secondReply.setComment("Second comment");
secondReply.setRepliedOn(Calendar.getInstance().getTime());

List<Reply> replies = new ArrayList<Reply>();
replies.add(firstReply);
replies.add(secondReply);

// Create an instance of AreaAnnotation class and set options
AreaAnnotation area = new AreaAnnotation();
area.setBackgroundColor(65535);
area.setBox(new Rectangle(100, 100, 100, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("This is area annotation");
area.setOpacity(0.7);
area.setPageNumber(0);
area.setPenColor(65535);
area.setPenStyle(PenStyle.Dot);
area.setPenWidth((byte) 3);
area.setReplies(replies);

// Create an instance of Annotator class
Annotator annotator = new Annotator("input.bmp");

// Add annotation
annotator.add(area);

// Save to file
annotator.save("output.bmp");
annotator.dispose();

Annotation preview image

Etapas para editar anotações de DOTX em Java

GroupDocs.Annotation torna mais fácil para os desenvolvedores Java atualizar várias propriedades de anotação de arquivos DOTX em qualquer aplicativo baseado em Java 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.

String outputPath = "UpdateAnnotation.bmp";

// Create an instance of Annotator class
Annotator annotator = new Annotator("input.bmp");

// Create an instance of Reply class for first example and add comments
Reply reply1 = new Reply();
reply1.setComment("Original first comment");
reply1.setRepliedOn(Calendar.getInstance().getTime());

Reply reply2 = new Reply();
reply2.setComment("Original second comment");
reply2.setRepliedOn(Calendar.getInstance().getTime());

java.util.List replies = new ArrayList();
replies.add(reply1);
replies.add(reply2);

// Create an instance of AreaAnnotation class and set options
AreaAnnotation original = new AreaAnnotation();
original.setId(1);
original.setBackgroundColor(65535);
original.setBox(new Rectangle(100, 100, 100, 100));
original.setCreatedOn(Calendar.getInstance().getTime());
original.setMessage("This is original annotation");
original.setReplies(replies);

// Add original annotation
annotator.add(original);
annotator.save(outputPath);
annotator.dispose();

LoadOptions loadOptions = new LoadOptions();

// Open annotated document
Annotator annotator1 = new Annotator(outputPath, loadOptions);

// Create an instance of Reply class for update first example
Reply reply3 = new Reply();
reply3.setComment("Updated first comment");
reply3.setRepliedOn(Calendar.getInstance().getTime());

Reply reply4 = new Reply();
reply4.setComment("Updated second comment");
reply4.setRepliedOn(Calendar.getInstance().getTime());

java.util.List replies1 = new ArrayList();
replies1.add(reply3);
replies1.add(reply4);

// Suggest we want change some properties of existed annotation
AreaAnnotation updated = new AreaAnnotation();
updated.setId(1);
updated.setBackgroundColor(255);
updated.setBox(new Rectangle(0, 0, 50, 200));
updated.setCreatedOn(Calendar.getInstance().getTime());
updated.setMessage("This is updated annotation");
updated.setReplies(replies1);

// Update and save annotation
annotator1.update(updated);
annotator1.save(outputPath);
annotator1.dispose();

Sobre o formato de arquivo DOTX

Arquivos com extensão DOTX são arquivos de modelo criados pelo Microsoft Word para ter configurações pré-formatadas para geração de outros arquivos DOCX. Um arquivo de modelo é criado para ter configurações de usuário específicas que devem ser aplicadas a moscas subsequentes criadas a partir delas. Essas configurações incluem margens de página, bordas, cabeçalhos, rodapés e outras configurações de página. Esses modelos são usados em documentos oficiais, como papéis timbrados da empresa e formulários padronizados. O formato de arquivo DOTX foi introduzido com o lançamento do Microsoft Office 2007 para substituir o formato de arquivo DOT binário, mas também é suportado por versões superiores. Por padrão, o Microsoft Word abre todos os novos documentos com base no arquivo normal.dot. Se modificado, todos os novos arquivos criados resultarão nas mesmas configurações do arquivo de modelo. No Microsoft Word 2007, o formato de arquivo DOT foi substituído pelo formato de arquivo DOTX baseado no Office OpenXML.

Trabalhando com outros formatos de documento populares

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

Anote DOTX de Java