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:
- Java API for Word DOC/DOCX Annotations
- Adicionar anotações ao Word
- Remover anotações de arquivos do Word
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çã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");
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 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");
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");
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.
- Carregue o documento.
- Inicialize opções de salvamento.
- Defina o tipo de anotação como Nenhum.
- Salve o arquivo do Word. Estará livre de anotações.
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.