Annotations interactives utilisant Java

Les annotations interactives de cette section se concentrent sur les flux de travail basés sur des liens et des boutons qui répondent aux actions de l’utilisateur dans une visionneuse PDF.

Ajouter une annotation de lien

Utilisez cet exemple lorsque vous devez placer un lien cliquable sur le texte trouvé sur la page.

  1. Ouvrez le PDF source Document.
  2. Localisez le fragment de texte cible et créez une LinkAnnotation sur son rectangle.
  3. Attribuez une GoToURIAction et enregistrez le document mis à jour.
public static void linkAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        TextFragmentAbsorber textFragmentAbsorber = new TextFragmentAbsorber("file");
        document.getPages().get_Item(1).accept(textFragmentAbsorber);

        var phoneNumberFragment = textFragmentAbsorber.getTextFragments().get_Item(1);
        LinkAnnotation linkAnnotation = new LinkAnnotation(
                document.getPages().get_Item(1),
                phoneNumberFragment.getRectangle());
        linkAnnotation.setAction(new GoToURIAction("https://www.aspose.com"));

        document.getPages().get_Item(1).getAnnotations().add(linkAnnotation);
        document.save(outputFile.toString());
    }
}

Obtenir des annotations de lien

Cet exemple analyse la collection d’annotations de page et indique l’emplacement de chaque annotation de lien.

  1. Ouvrez le PDF source Document.
  2. Parcourez les annotations sur la page cible.
  3. Filtrez les annotations par AnnotationType.Link et affichez leurs rectangles.
public static void linkGet(Path inputFile) {
    try (Document document = new Document(inputFile.toString())) {
        for (Annotation annotation : document.getPages().get_Item(1).getAnnotations()) {
            if (annotation.getAnnotationType() == AnnotationType.Link) {
                System.out.println(annotation.getRect());
            }
        }
    }
}

Supprimer les annotations du lien

Utilisez cette approche lorsque les annotations de liens existantes doivent être supprimées de la page.

  1. Ouvrez le PDF source Document.
  2. Collectez les annotations dont le type est AnnotationType.Link.
  3. Supprimez les annotations collectées et enregistrez le fichier de sortie.
public static void linkDelete(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.Link) {
                toDelete.add(annotation);
            }
        }
        for (Annotation annotation : toDelete) {
            document.getPages().get_Item(1).getAnnotations().delete(annotation);
        }
        document.save(outputFile.toString());
    }
}

Ajouter une annotation de ligne

Cet exemple crée une annotation de ligne interactive avec des styles de flèches, des paramètres de bordure et une note contextuelle.

  1. Ouvrez le PDF source Document.
  2. Créez une LineAnnotation avec des points de début et de fin.
  3. Configurez son apparence et son annotation contextuelle, puis enregistrez le document.
public static void lineAnnotationAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        LineAnnotation lineAnnotation = new LineAnnotation(
                document.getPages().get_Item(1),
                new Rectangle(550, 93, 562, 439, true),
                new Point(556, 99),
                new Point(556, 443));

        lineAnnotation.setTitle("John Smith");
        lineAnnotation.setColor(Color.getRed());
        lineAnnotation.setStartingStyle(LineEnding.OpenArrow);
        lineAnnotation.setEndingStyle(LineEnding.OpenArrow);

        Border border = new Border(lineAnnotation);
        border.setWidth(3);
        lineAnnotation.setBorder(border);

        PopupAnnotation popup = new PopupAnnotation(
                document.getPages().get_Item(1),
                new Rectangle(842, 124, 1021, 266, true));
        lineAnnotation.setPopup(popup);

        document.getPages().get_Item(1).getAnnotations().add(lineAnnotation);
        document.save(outputFile.toString());
    }
}

Ajouter des boutons de navigation

Utilisez cet exemple lorsque le PDF doit inclure des boutons de page précédente et de page suivante pour une navigation interactive.

  1. Ouvrez le PDF source Document et assurez-vous que le document contient les pages requises.
  2. Créez des contrôles ButtonField avec des actions de navigation prédéfinies.
  3. Ajoutez les boutons à la collection de formulaires et enregistrez le document mis à jour.
public static void navigationButtonsAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        document.getPages().add();

        record ButtonConfig(String name, double xPos, PredefinedAction action) {}
        List<ButtonConfig> buttonConfigs = List.of(
                new ButtonConfig("Previous Page", 120.0, PredefinedAction.PrevPage),
                new ButtonConfig("Next Page", 230.0, PredefinedAction.NextPage));

        for (Page page : document.getPages()) {
            for (ButtonConfig config : buttonConfigs) {
                Rectangle rect = new Rectangle(config.xPos(), 10.0, config.xPos() + 100, 40.0, true);
                ButtonField button = new ButtonField(page, rect);
                button.setPartialName(config.name());
                button.setValue(config.name());
                button.getCharacteristics().setBorder(Color.getRed());
                button.getCharacteristics().setBackground(Color.getOrange().toRgb());
                button.getAnnotationActions().setOnReleaseMouseBtn(new NamedAction(config.action()));
                document.getForm().add(button);
            }
        }
        document.save(outputFile.toString());
    }
}

Ajouter un bouton d’impression

Cet exemple crée un bouton qui déclenche la commande d’impression lorsque l’utilisateur clique dessus.

  1. Créez un nouveau document PDF Document et ajoutez une page.
  2. Créez un ButtonField et attribuez l’action prédéfinie d’impression.
  3. Configurez la bordure et l’arrière-plan du bouton, ajoutez-les au formulaire et enregistrez le document.
public static void printButtonAdd(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();

        Rectangle rect = new Rectangle(72, 748, 164, 768, true);
        ButtonField printButton = new ButtonField(page, rect);
        printButton.setAlternateName("Print current document");
        printButton.setColor(Color.getBlack());
        printButton.setPartialName("printBtn1");
        printButton.setValue("Print Document");
        printButton.getAnnotationActions().setOnReleaseMouseBtn(
                new NamedAction(PredefinedAction.File_Print));

        Border border = new Border(printButton);
        border.setStyle(BorderStyle.Solid);
        border.setWidth(2);
        printButton.setBorder(border);

        printButton.getCharacteristics().setBorder(Color.getBlue());
        printButton.getCharacteristics().setBackground(Color.getLightBlue().toRgb());

        document.getForm().add(printButton);
        document.save(outputFile.toString());
    }
}
Annotations des médias en PDF Annotations en filigrane utilisant Java