Комментарии к презентации

В PowerPoint комментарий появляется как заметка или аннотация на слайде. Когда комментарий нажимается, его содержимое или сообщения становятся видимыми.

Зачем добавлять комментарии в презентации?

Вы можете использовать комментарии для предоставления обратной связи или общения с вашими коллегами при просмотре презентаций.

Чтобы позволить вам использовать комментарии в презентациях PowerPoint, Aspose.Slides для Java предоставляет

Класс Presentation, который содержит коллекции авторов (из интерфейса ICommentAuthorCollection). Авторы добавляют комментарии к слайдам.
Интерфейс ICommentCollection, который содержит коллекцию комментариев для отдельных авторов.
Класс IComment, который содержит информацию об авторах и их комментариях: кто добавил комментарий, время добавления комментария, позиция комментария и т.д.
Класс CommentAuthor, который содержит информацию об отдельных авторах: имя автора, его инициалы, комментарии, связанные с именем автора и т.д.

Добавить комментарий на слайд

Этот код на Java показывает, как добавить комментарий на слайд в презентации PowerPoint:

// Создает экземпляр класса Presentation
Presentation pres = new Presentation();
try {
    // Добавляет пустой слайд
    pres.getSlides().addEmptySlide(pres.getLayoutSlides().get_Item(0));

    // Добавляет автора
    ICommentAuthor author = pres.getCommentAuthors().addAuthor("Jawad", "MF");

    // Устанавливает позицию для комментариев
    Point2D.Float point = new Point2D.Float(0.2f, 0.2f);

    // Добавляет комментарий на слайд для автора на слайде 1
    author.getComments().addComment("Привет Jawad, это комментарий к слайду", pres.getSlides().get_Item(0), point, new Date());

    // Добавляет комментарий на слайд для автора на слайде 2
    author.getComments().addComment("Привет Jawad, это второй комментарий к слайду", pres.getSlides().get_Item(1), point, new Date());

    // Получает ISlide 1
    ISlide slide = pres.getSlides().get_Item(0);

    // Когда null передается как аргумент, комментарии от всех авторов добавляются к выбранному слайду
    IComment[] Comments = slide.getSlideComments(author);

    // Получает комментарий по индексу 0 для слайда 1
    String str = Comments[0].getText();

    pres.save("Comments_out.pptx", SaveFormat.Pptx);

    if (Comments.length > 0)
    {
        // Выбирает коллекцию комментариев автора по индексу 0
        ICommentCollection commentCollection = Comments[0].getAuthor().getComments();
        String Comment = commentCollection.get_Item(0).getText();
    }
} finally {
    if (pres != null) pres.dispose();
}

Доступ к комментариям на слайде

Этот код на Java показывает, как получить доступ к существующему комментарию на слайде в презентации PowerPoint:

// Создает экземпляр класса Presentation
Presentation pres = new Presentation("Comments1.pptx");
try {
    for (ICommentAuthor commentAuthor : pres.getCommentAuthors())
    {
        CommentAuthor author = (CommentAuthor) commentAuthor;
        for (IComment comment1 : author.getComments())
        {
            Comment comment = (Comment) comment1;
            System.out.println("ISlide :" + comment.getSlide().getSlideNumber() + " имеет комментарий: " + comment.getText() +
                    " от автора: " + comment.getAuthor().getName() + " опубликованное в:" + comment.getCreatedTime() + "\n");
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Ответы на комментарии

Родительский комментарий — это верхний или исходный комментарий в иерархии комментариев или ответов. Используя методы getParentComment или setParentComment (из интерфейса IComment), вы можете установить или получить родительский комментарий.

Этот код на Java показывает, как добавлять комментарии и получать на них ответы:

Presentation pres = new Presentation();
try {
    // Добавляет комментарий
    ICommentAuthor author1 = pres.getCommentAuthors().addAuthor("Автор_1", "A.A.");
    IComment comment1 = author1.getComments().addComment("комментарий 1", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());

    // Добавляет ответ на comment1
    ICommentAuthor author2 = pres.getCommentAuthors().addAuthor("Автор_2", "B.B.");
    IComment reply1 = author2.getComments().addComment("ответ 1 на комментарий 1", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());
    reply1.setParentComment(comment1);

    // Добавляет другой ответ на comment1
    IComment reply2 = author2.getComments().addComment("ответ 2 на комментарий 1", pres.getSlides().get_Item(0),  new Point2D.Float(10, 10), new Date());
    reply2.setParentComment(comment1);

    // Добавляет ответ к существующему ответу
    IComment subReply = author1.getComments().addComment("подответ 3 на ответ 2", pres.getSlides().get_Item(0),  new Point2D.Float(10, 10), new Date());
    subReply.setParentComment(reply2);

    IComment comment2 = author2.getComments().addComment("комментарий 2", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());
    IComment comment3 = author2.getComments().addComment("комментарий 3", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());

    IComment reply3 = author1.getComments().addComment("ответ 4 на комментарий 3", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());
    reply3.setParentComment(comment3);

    // Отображает иерархию комментариев в консоли
    ISlide slide = pres.getSlides().get_Item(0);
    IComment[] comments = slide.getSlideComments(null);
    for (int i = 0; i < comments.length; i++)
    {
        IComment comment = comments[i];
        while (comment.getParentComment() != null)
        {
            System.out.print("\t");
            comment = comment.getParentComment();
        }

        System.out.println(comments[i].getAuthor().getName() +  " : " + comments[i].getText());
        System.out.println();
    }
    pres.save("parent_comment.pptx",SaveFormat.Pptx);

    // Удаляет comment1 и все ответы на него
    comment1.remove();

    pres.save("remove_comment.pptx",SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Внимание

Когда метод Remove (из интерфейса IComment) используется для удаления комментария, ответы на комментарий также удаляются.
Если установка setParentComment приводит к круговой ссылке, будет выброшено исключение PptxEditException.

Добавить современный комментарий

В 2021 году Microsoft представила современные комментарии в PowerPoint. Функция современных комментариев существенно улучшает совместную работу в PowerPoint. Через современные комментарии пользователи PowerPoint могут решать комментарии, привязывать комментарии к объектам и текстам и взаимодействовать намного проще, чем раньше.

В Aspose Slides для Java 21.11 мы реализовали поддержку современных комментариев, добавив класс ModernComment. Методы addModernComment и insertModernComment были добавлены в класс CommentCollection.

Этот код на Java показывает, как добавить современный комментарий на слайд в презентации PowerPoint:

Presentation pres = new Presentation();
try {
    ICommentAuthor newAuthor = pres.getCommentAuthors().addAuthor("Некоторый Автор", "SA");
    IModernComment modernComment = newAuthor.getComments().addModernComment("Это современный комментарий", pres.getSlides().get_Item(0), null, new Point2D.Float(100, 100), new Date());

    pres.save("pres.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Удалить комментарий

Удалить все комментарии и авторов

Этот код на Java показывает, как удалить все комментарии и авторов в презентации:

Presentation presentation = new Presentation("example.pptx");
try {
    // Удаляет все комментарии из презентации
    for (ICommentAuthor author : presentation.getCommentAuthors())
    {
        author.getComments().clear();
    }

    // Удаляет всех авторов
    presentation.getCommentAuthors().clear();

    presentation.save("example_out.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

Удалить конкретные комментарии

Этот код на Java показывает, как удалить конкретные комментарии на слайде:

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // добавляет комментарии...
    ICommentAuthor author = presentation.getCommentAuthors().addAuthor("Автор", "A");
    author.getComments().addComment("комментарий 1", slide, new Point2D.Float(0.2f, 0.2f), new Date());
    author.getComments().addComment("комментарий 2", slide, new Point2D.Float(0.3f, 0.2f), new Date());

    // удаляет все комментарии, содержащие текст "комментарий 1"
    for (ICommentAuthor commentAuthor : presentation.getCommentAuthors())
    {
        ArrayList<IComment> toRemove = new ArrayList<IComment>();
        for (IComment comment : slide.getSlideComments(commentAuthor))
        {
            if (comment.getText().equals("комментарий 1"))
            {
                toRemove.add(comment);
            }
        }

        for (IComment comment : toRemove)
        {
            commentAuthor.getComments().remove(comment);
        }
    }

    presentation.save("pres.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

Свойства презентации Заметки к презентации