As anotações são normalmente usadas para mencionar erros em documentos ou para discutir seu conteúdo. Com anotações, você pode evitar discussões longas e intermináveis em tópicos de e-mails. Neste artigo, você aprenderá como adicionar e remover anotações programaticamente para marcar documentos do Word em Java.

A seguir estão os tópicos discutidos brevemente abaixo:

API Java para anotar e marcar arquivos do Word

GroupDocs.Annotation fornece a API Java para lidar com as anotações. A API permite a adição, remoção e extração de anotações de documentos do Word e muitos outros formatos de arquivo. Formatos de documento suportados incluem; planilhas, apresentações, imagens, arquivos PDF, páginas da Web, mensagens de e-mail, desenhos do Visio.

Baixe ou configure

Baixe o arquivo JAR da seção de downloads ou apenas obtenha as configurações de repositório e dependência mais recentes para o pom.xml do seu *baseado em maven * Aplicativos Java.

<repository>
	<id>GroupDocsJavaAPI</id>
	<name>GroupDocs Java API</name>
	<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-annotation</artifactId>
        <version>21.7.2</version> 
</dependency>

Adicionar anotações ao Word em Java

Vamos adicionar diferentes tipos de anotações aos documentos do Word. As anotações são de vários tipos, portanto, abordaremos apenas algumas aqui.

Adicionar anotações ao DOC DOCX usando a API GroupDocs

Adicionar anotação de seta ao Word em Java

A seguir estão as etapas para adicionar uma anotação de seta a um documento do Word em Java.

  • Carregue o documento usando a classe Annotator.
  • Inicialize a anotação de seta com a classe ArrowAnnotation.
  • Ajuste a posição, tamanho, número de página da anotação de seta.
  • Adicione a anotação de seta criada usando o método add().
  • Salve o documento do Word anotado no caminho usando o método save() apropriado.

O exemplo de código Java a seguir mostra como adicionar uma anotação de seta a um documento do Word.

// Adicionar anotação de seta a documentos do Word em Java
final Annotator annotator = new Annotator("path/document.docx");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100));
arrow.setMessage("Arrow annotation");
arrow.setOpacity(0.7);
arrow.setPageNumber(0);
arrow.setPenColor(0x65535);
arrow.setPenStyle(PenStyle.Dot);
arrow.setPenWidth((byte) 3);
annotator.add(arrow);
annotator.save("path/annotatedDoc.docx");
Adicionar anotação de seta programaticamente em Java e .NET

Inserir anotação de retângulo ou área no Word em Java

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

  • Carregue o documento Word DOC/DOCX usando a classe Annotator.
  • Inicialize a anotação do retângulo usando a classe AreaAnnotation.
  • Ajuste a posição, tamanho e cor do retângulo.
  • Defina outras propriedades, como número da página, plano de fundo, opacidade, estilo, largura da caneta, mensagens e hora.
  • Adicione a anotação de retângulo criada ao Anotador.
  • Salve o documento do Word anotado no caminho usando o método save().

O exemplo de código Java a seguir mostra como adicionar anotação de retângulo/área a um documento do Word.

// Adicionar anotação de área ou retângulo em documentos do Word em Java

final Annotator annotator = new Annotator("path/document.docx");

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);
annotator.add(area);
annotator.save("path/annotatedDoc.docx");
Adicionar anotação de retângulo ou área programaticamente em .NET e Java

Adicionar anotação oval ou elipse ao Word em Java

A seguir estão as etapas para adicionar anotação oval/elipse a um documento em Java.

  • Carregue o documento DOC/DOCX usando a classe Annotator.
  • Inicialize a anotação de elipse usando a classe EllipseAnnotation.
  • Defina a posição e o tamanho da anotação de elipse inicializada.
  • Adicione a anotação de elipse criada ao Anotador.
  • Salve o arquivo do Word anotado usando o método save() apropriado.

O exemplo de código Java a seguir mostra como adicionar anotação oval/elipse a qualquer documento do Word.

// Adicionar anotação oval ou elipse em documentos do Word em Java
final Annotator annotator = new Annotator("path/document.docx");

EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBackgroundColor(65535);
ellipse.setBox(new Rectangle(100, 100, 100, 100));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("This is ellipse annotation");
ellipse.setOpacity(0.7);
ellipse.setPageNumber(0);
ellipse.setPenColor(65535);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies);
annotator.add(ellipse);
annotator.save("path/annotatedDoc.docx");
Adicionar elipses ou anotação oval programaticamente em C# .NET e Java

Inserir anotação de distância no Word em Java

Da mesma forma, você pode mencionar a distância entre dois pontos usando a anotação de distância. A seguir estão as etapas para adicionar anotação de distância ao documento em Java.

  • Após carregar o documento do Word, inicialize a anotação de distância usando a classe DistanceAnnotation.
  • Defina a aparência da anotação.
  • Adicione a anotação de distância ao objeto Anotador.
  • Salve o documento anotado no local fornecido ou use o método save() correto,

A amostra de código Java a seguir mostra como adicionar anotação de distância a um documento DOC/DOCX.

// Adicionar anotação de distância a documentos do Word em Java
final Annotator annotator = new Annotator("path/document.docx");

DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(200, 150, 200, 30));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is distance annotation");
distance.setOpacity(0.7);
distance.setPageNumber(0);
distance.setPenColor(65535);
distance.setPenStyle(PenStyle.Dot);
distance.setPenWidth((byte) 3);
distance.setReplies(replies);
annotator.add(distance);
annotator.save("path/annotatedDoc.docx");
Adicionar anotação de distância programaticamente em C# .NET e Java

Remover anotações de arquivos Word DOC/DOCX em Java

Há muitas maneiras de remover anotações de documentos do Word. Você pode remover anotações específicas fornecendo os índices para remover as anotações específicas. Além disso, você pode remover todas as anotações de uma vez. Detalhes e código-fonte Java para remover anotações são discutidos em um artigo separado.

A seguir estão as etapas para remover todas as anotações de um arquivo do Word.

O código a seguir mostra como remover anotações de um arquivo do Word em Java.

// Remova todas as anotações do documento do Word em Java
final Annotator annotator = new Annotator("path/annotatedDoc.docx");

SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
annotator.save("path/annotationsRemoved.docx", saveOptions);

Conclusão

Para resumir, você aprendeu como adicionar anotações a documentos do Word em aplicativos Java. Especificamente, adicionamos anotações de seta, elipse, área e distância ao arquivo Word DOC/DOCX usando GroupDocs.Annotation for Java. Além disso, você também viu como remover todas as anotações de qualquer arquivo do Word. Agora, você pode tentar construir seu próprio aplicativo Java anotador de documentos.

Saiba mais sobre a API no repositório documentation e no GitHub. Para mais dúvidas, entre em contato com o suporte no fórum.

Veja também