Comments and Notes

Trabalhar com comentários e notas do orador Aspose.Slides FOSS para Java

Este guia mostra como adicionar e ler comentários com thread e notas de orador em apresentações PPTX usando Aspose.Slides FOSS para Java. Dois tipos de anotação são suportados: comentários de diapositivas com rosca (visível no modo de revisão) e notas do orador (visível na Vista do apresentador e no painel Notas).

Comentários com tópicos

Os comentários estão anexados a um diapositivo e associados com o autor. prs.getCommentAuthors() A colecção gerencia todos os autores; cada autor tem um getComments() coleção para adicionar e ler comentários.

Adicionar um Comentário

Chama-me . prs.getCommentAuthors().addAuthor() para criar um autor, em seguida, chamar author.getComments().addComment() com o diapositivo, texto, posição e marca de hora:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.drawing.PointF;
import org.aspose.slides.foss.export.SaveFormat;
import java.time.LocalDateTime;

try (Presentation prs = new Presentation()) {
    // Create a comment author with initials
    var author = prs.getCommentAuthors().addAuthor("Jane Smith", "JS");

    var slide = prs.getSlides().get(0);

    // Add a comment at position (2.0, 2.0) centimeters from the slide top-left
    author.getComments().addComment(
        "Please review the figures on this slide",
        slide,
        new PointF(2.0f, 2.0f),
        LocalDateTime.now()
    );

    prs.save("commented.pptx", SaveFormat.PPTX);
}

A Comissão PointF posição está em: centímetros A partir do canto superior esquerdo da imagem (gordado internamente como UEM; 1 cm = 360.000 UME). Pode acrescentar-se vários comentários à mesma imagen através de um telefone: addComment() - Mais uma vez.

Vários autores e comentários

Crie autores separados para cada revisor e adicione comentários independentes de diferentes autores ao mesmo slide:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.drawing.PointF;
import org.aspose.slides.foss.export.SaveFormat;
import java.time.LocalDateTime;

try (Presentation prs = new Presentation()) {
    var author1 = prs.getCommentAuthors().addAuthor("Alice Brown", "AB");
    var author2 = prs.getCommentAuthors().addAuthor("Bob Davis", "BD");

    var slide = prs.getSlides().get(0);

    author1.getComments().addComment("Initial draft", slide, new PointF(1.0f, 1.0f), LocalDateTime.now());
    author2.getComments().addComment("Approved", slide, new PointF(3.0f, 1.0f), LocalDateTime.now());

    prs.save("multi-author.pptx", SaveFormat.PPTX);
}

Leia comentários de um arquivo existente

Iteração prs.getCommentAuthors() para acessar cada autor, e depois iterar author.getComments() para ler o texto do comentário:

import org.aspose.slides.foss.Presentation;

try (Presentation prs = new Presentation("commented.pptx")) {
    for (int a = 0; a < prs.getCommentAuthors().size(); a++) {
        var author = prs.getCommentAuthors().get(a);
        System.out.println("Author: " + author.getName() + " (" + author.getInitials() + ")");
        for (int c = 0; c < author.getComments().size(); c++) {
            var comment = author.getComments().get(c);
            System.out.println("  " + comment.getText());
        }
    }
}

Notas do orador

As notas do orador são armazenadas por diapositiva através de um NotesSlide Objeto. Acessá-lo através de slide.getNotesSlideManager().

Adicionar notas de orador a um slide

Chama-me . slide.getNotesSlideManager().addNotesSlide() para criar um slide de notas, em seguida, configurar o texto no notes.getNotesTextFrame():

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    var slide = prs.getSlides().get(0);
    slide.getShapes().addAutoShape(ShapeType.RECTANGLE, 50, 50, 400, 200);

    // Create the notes slide and set text
    var notes = slide.getNotesSlideManager().addNotesSlide();
    notes.getNotesTextFrame().setText(
        "Mention the Q3 revenue increase on this slide. Emphasize the 24% growth."
    );

    prs.save("with-notes.pptx", SaveFormat.PPTX);
}

Exemplo de notas mais simples

A chamada para a addNotesSlide() funciona da mesma forma, independentemente de quais formas estão no slide adicionar uma forma e criar as notas:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    var slide = prs.getSlides().get(0);
    slide.getShapes().addAutoShape(ShapeType.RECTANGLE, 100, 100, 500, 250)
         .addTextFrame("Main Content");

    var notes = slide.getNotesSlideManager().addNotesSlide();
    notes.getNotesTextFrame().setText("These are the speaker notes for this slide.");

    prs.save("notes.pptx", SaveFormat.PPTX);
}

Verifique se um slide de notas já existe

getNotesSlideManager().getNotesSlide() Renda de rendimentos null se ainda não tiver sido criado nenhum diapositivo de notas:

import org.aspose.slides.foss.Presentation;

try (Presentation prs = new Presentation("existing.pptx")) {
    for (int i = 0; i < prs.getSlides().size(); i++) {
        var slide = prs.getSlides().get(i);
        var existingNotes = slide.getNotesSlideManager().getNotesSlide();
        if (existingNotes != null) {
            String text = existingNotes.getNotesTextFrame().getText();
            System.out.println("Slide " + (i + 1) + " notes: " + text);
        } else {
            System.out.println("Slide " + (i + 1) + ": no notes");
        }
    }
}

Adicionar notas a vários slides

Iteração prs.getSlides() E chama-me. addNotesSlide() Em cada diapositiva, anexar uma nota do orador a partir de um conjunto de linhas de texto preparadas:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

String[] noteTexts = {
    "Opening remarks: introduce the agenda.",
    "Key metrics: emphasize Q4 results.",
    "Closing: call to action.",
};

try (Presentation prs = new Presentation()) {
    // Add slides 2 and 3
    var layout = prs.getSlides().get(0).getLayoutSlide();
    prs.getSlides().addEmptySlide(layout);
    prs.getSlides().addEmptySlide(layout);

    for (int i = 0; i < prs.getSlides().size(); i++) {
        var slide = prs.getSlides().get(i);
        slide.getShapes().addAutoShape(ShapeType.RECTANGLE, 50, 50, 600, 300)
             .addTextFrame("Slide " + (i + 1));
        var n = slide.getNotesSlideManager().addNotesSlide();
        n.getNotesTextFrame().setText(noteTexts[i]);
    }

    prs.save("all-notes.pptx", SaveFormat.PPTX);
}