Anotações de marcação usando Java

Os fluxos de trabalho de anotações de marcação nesta seção enfocam comentários no estilo de nota, marcadores de cursor e cenários agrupados de substituição-revisão.

Adicionar uma anotação de texto

Use este exemplo quando precisar colocar uma anotação de texto no estilo de nota adesiva com metadados de pop-up em uma página.

  1. Abra o PDF de origem em um objeto Document.
  2. Crie um TextAnnotation e configure seu título, conteúdos, ícone e popup.
  3. Adicione a anotação à página e salve o documento.
public static void textAnnotationAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        TextAnnotation textAnnotation = new TextAnnotation(
                document.getPages().get_Item(1),
                new Rectangle(299.988, 613.664, 428.708, 680.769, true));
        textAnnotation.setTitle("Aspose User");
        textAnnotation.setSubject("Sticky Note");
        textAnnotation.setContents("This is a text annotation added by Aspose.PDF for Java");
        textAnnotation.setFlags(AnnotationFlags.Print);
        textAnnotation.setColor(Color.getBlue());
        textAnnotation.setIcon(TextIcon.Help);

        PopupAnnotation popup = new PopupAnnotation(
                document.getPages().get_Item(1),
                new Rectangle(428.708, 613.664, 528.708, 713.664, true));
        popup.setOpen(true);
        textAnnotation.setPopup(popup);

        document.getPages().get_Item(1).getAnnotations().add(textAnnotation, false);
        document.save(outputFile.toString());
    }
}

Obter anotações de texto

Este exemplo varre a página e imprime o retângulo de cada anotação de texto.

  1. Abra o PDF de origem em um objeto Document.
  2. Itere pelas anotações na página.
  3. Filtre anotações por AnnotationType.Text e imprima seus retângulos.
public static void textAnnotationGet(Path inputFile) {
    try (Document document = new Document(inputFile.toString())) {
        for (Annotation annotation : document.getPages().get_Item(1).getAnnotations()) {
            if (annotation.getAnnotationType() == AnnotationType.Text) {
                System.out.println(annotation.getRect());
            }
        }
    }
}

Excluir anotações de texto

Use esta abordagem quando as anotações de texto existentes devem ser removidas do documento.

  1. Abra o PDF de origem em um objeto Document.
  2. Colete anotações do tipo AnnotationType.Text.
  3. Exclua as anotações coletadas e salve o arquivo de saída.
public static void textAnnotationDelete(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        List<Annotation> toDelete = new ArrayList<>();
        for (Annotation annotation : document.getPages().get_Item(1).getAnnotations()) {
            if (annotation.getAnnotationType() == AnnotationType.Text) {
                toDelete.add(annotation);
            }
        }
        for (Annotation annotation : toDelete) {
            document.getPages().get_Item(1).getAnnotations().delete(annotation);
        }
        document.save(outputFile.toString());
    }
}

Adicionar uma anotação caret

Use este exemplo quando precisar marcar texto inserido com uma anotação de revisão no estilo caret.

  1. Abra o PDF de origem em um objeto Document.
  2. Crie um CaretAnnotation e configure seu pop-up e aparência.
  3. Adicione a anotação à página e salve o documento.
public static void caretAnnotationsAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        Page page = document.getPages().get_Item(1);

        CaretAnnotation caretAnnotation = new CaretAnnotation(
                page,
                new Rectangle(299.988, 713.664, 308.708, 720.769, true));
        caretAnnotation.setTitle("Aspose User");
        caretAnnotation.setSubject("Inserted text 1");
        caretAnnotation.setFlags(AnnotationFlags.Print);
        caretAnnotation.setColor(Color.getBlue());
        caretAnnotation.setPopup(new PopupAnnotation(
                page,
                new Rectangle(310, 713, 410, 730, true)));
        page.getAnnotations().add(caretAnnotation);

        document.save(outputFile.toString());
    }
}

Obter anotações de caret

Este exemplo lê anotações de cursor existentes e imprime suas localizações.

  1. Abra o PDF de origem em um objeto Document.
  2. Itere pelas anotações da página.
  3. Filtre anotações por AnnotationType.Caret e imprima seus retângulos.
public static void caretAnnotationsGet(Path inputFile) {
    try (Document document = new Document(inputFile.toString())) {
        Page page = document.getPages().get_Item(1);
        for (Annotation annot : page.getAnnotations()) {
            if (annot.getAnnotationType() == AnnotationType.Caret) {
                System.out.println(annot.getRect());
            }
        }
    }
}

Excluir anotações de cursor

Use esta abordagem quando as anotações de caret devem ser removidas da página.

  1. Abra o PDF de origem em um objeto Document.
  2. Colete anotações cujo tipo é AnnotationType.Caret.
  3. Exclua as anotações coletadas e salve o documento de saída.
public static void caretAnnotationsDelete(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        Page page = document.getPages().get_Item(1);

        List<Annotation> caretAnnotations = new ArrayList<>();
        for (Annotation annot : page.getAnnotations()) {
            if (annot.getAnnotationType() == AnnotationType.Caret) {
                caretAnnotations.add(annot);
            }
        }
        for (Annotation annot : caretAnnotations) {
            page.getAnnotations().delete(annot);
        }
        document.save(outputFile.toString());
    }
}

Adicionar anotações de substituição agrupadas

Este exemplo combina uma anotação caret com uma anotação de tachado para representar um comentário de revisão no estilo substituir.

  1. Abra o PDF de origem em um objeto Document.
  2. Crie a anotação de caret e o relacionado StrikeOutAnnotation.
  3. Vincule as anotações através setInReplyTo e setReplyType, então salve o documento.
public static void replaceAnnotationsAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        Page page = document.getPages().get_Item(1);

        CaretAnnotation caretAnnotation = new CaretAnnotation(
                page,
                new Rectangle(361.246, 727.908, 370.081, 735.107, true));
        caretAnnotation.setFlags(AnnotationFlags.Print);
        caretAnnotation.setSubject("Inserted text 2");
        caretAnnotation.setTitle("Aspose User");
        caretAnnotation.setColor(Color.getBlue());
        caretAnnotation.setPopup(new PopupAnnotation(
                page,
                new Rectangle(310, 713, 410, 730, true)));

        StrikeOutAnnotation strikeoutAnnotation = new StrikeOutAnnotation(
                page,
                new Rectangle(318.407, 727.826, 368.916, 740.098, true));
        strikeoutAnnotation.setColor(Color.getBlue());
        strikeoutAnnotation.setQuadPoints(new Point[]{
                new Point(321.66, 739.416),
                new Point(365.664, 739.416),
                new Point(321.66, 728.508),
                new Point(365.664, 728.508)
        });
        strikeoutAnnotation.setSubject("Cross-out");
        strikeoutAnnotation.setInReplyTo(caretAnnotation);
        strikeoutAnnotation.setReplyType(ReplyType.Group);

        page.getAnnotations().add(caretAnnotation);
        page.getAnnotations().add(strikeoutAnnotation);

        document.save(outputFile.toString());
    }
}

Obter anotações de substituição agrupadas

Este exemplo detecta anotações de tachado que participam de um fluxo de trabalho de substituição agrupada.

  1. Abra o PDF de origem em um objeto Document.
  2. Itere pelas anotações da página e selecione as anotações de tachado.
  3. Verifique a relação de resposta e imprima o retângulo das anotações correspondentes.
public static void replaceAnnotationsGet(Path inputFile) {
    try (Document document = new Document(inputFile.toString())) {
        Page page = document.getPages().get_Item(1);
        for (Annotation annot : page.getAnnotations()) {
            if (annot.getAnnotationType() == AnnotationType.StrikeOut) {
                StrikeOutAnnotation sa = (StrikeOutAnnotation) annot;
                if (sa.getInReplyTo() != null && sa.getReplyType() == ReplyType.Group) {
                    System.out.println("Replace annotation rect: " + sa.getRect());
                }
            }
        }
    }
}

Excluir anotações de substituição agrupadas

Use esta abordagem quando as anotações de strikeout replace-review devem ser removidas da página.

  1. Abra o PDF de origem em um objeto Document.
  2. Colete anotações de tachado que representam a marcação de substituição.
  3. Exclua as anotações coletadas e salve o documento atualizado.
public static void replaceAnnotationsDelete(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        Page page = document.getPages().get_Item(1);

        List<StrikeOutAnnotation> replaceAnnotations = new ArrayList<>();
        for (Annotation annot : page.getAnnotations()) {
            if (annot.getAnnotationType() == AnnotationType.StrikeOut) {
                replaceAnnotations.add((StrikeOutAnnotation) annot);
            }
        }
        for (StrikeOutAnnotation annot : replaceAnnotations) {
            page.getAnnotations().delete(annot);
        }
        document.save(outputFile.toString());
    }
}

Tópicos relacionados à anotação

Anotações de forma via Java Anotações de mídia em PDF