Комментарии к презентациям
В PowerPoint комментарий отображается как заметка или аннотация на слайде. При щелчке по комментарию его содержимое или сообщения раскрываются.
Зачем добавлять комментарии к презентациям?
Вы можете использовать комментарии, чтобы дать обратную связь или общаться с коллегами при просмотре презентаций.
Для возможности использования комментариев в презентациях PowerPoint, Aspose.Slides for Node.js via Java предоставляет
- Класс Presentation, который содержит коллекции авторов (из класса CommentAuthorCollection). Авторы добавляют комментарии к слайдам.
- Класс CommentCollection, который содержит коллекцию комментариев для отдельных авторов.
- Класс Comment, который содержит информацию об авторах и их комментариях: кто добавил комментарий, время его добавления, позицию комментария и т.д.
- Класс CommentAuthor, который содержит информацию об отдельных авторах: имя автора, его инициалы, комментарии, связанные с именем автора, и т.д.
Добавить комментарий к слайду
Этот код JavaScript показывает, как добавить комментарий к слайду в презентации PowerPoint:
// Создает экземпляр класса Presentation
var pres = new aspose.slides.Presentation();
try {
// Добавляет пустой слайд
pres.getSlides().addEmptySlide(pres.getLayoutSlides().get_Item(0));
// Добавляет автора
var author = pres.getCommentAuthors().addAuthor("Jawad", "MF");
// Устанавливает позицию для комментариев
var point = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(0.2), java.newFloat(0.2));
// Добавляет комментарий к слайду для автора на слайде 1
author.getComments().addComment("Hello Jawad, this is slide comment", pres.getSlides().get_Item(0), point, java.newInstanceSync("java.util.Date"));
// Добавляет комментарий к слайду для автора на слайде 2
author.getComments().addComment("Hello Jawad, this is second slide comment", pres.getSlides().get_Item(1), point, java.newInstanceSync("java.util.Date"));
// Получает ISlide 1
var slide = pres.getSlides().get_Item(0);
// Когда в качестве аргумента передаётся null, комментарии всех авторов помещаются на выбранный слайд
var Comments = slide.getSlideComments(author);
// Получает комментарий с индексом 0 для слайда 1
var str = Comments[0].getText();
pres.save("Comments_out.pptx", aspose.slides.SaveFormat.Pptx);
if (Comments.length > 0) {
// Выбирает коллекцию комментариев автора с индексом 0
var commentCollection = Comments[0].getAuthor().getComments();
var Comment = commentCollection.get_Item(0).getText();
}
} finally {
if (pres != null) {
pres.dispose();
}
}
Доступ к комментариям слайда
Этот код JavaScript показывает, как получить доступ к существующему комментарию на слайде в презентации PowerPoint:
var pres = new aspose.slides.Presentation("Comments1.pptx");
try {
for (let i = 0; i < pres.getCommentAuthors().size(); i++) {
let commentAuthor = pres.getCommentAuthors().get_Item(i);
for (let j = 0; j < commentAuthor.getComments().size(); j++) {
const comment = commentAuthor.getComments().get_Item(j);
console.log("ISlide :" + comment.getSlide().getSlideNumber() + " has comment: " + comment.getText() + " with Author: " + comment.getAuthor().getName() + " posted on time :" + comment.getCreatedTime() + "\n");
}
}
} finally {
if (pres != null) {
pres.dispose();
}
}
Ответы на комментарии
Родительский комментарий — это верхний или оригинальный комментарий в иерархии комментариев или ответов. С помощью методов getParentComment или setParentComment (из класса Comment) вы можете установить или получить родительский комментарий.
Этот код JavaScript показывает, как добавить комментарии и получить ответы на них:
var pres = new aspose.slides.Presentation();
try {
// Добавляет комментарий
var author1 = pres.getCommentAuthors().addAuthor("Author_1", "A.A.");
var comment1 = author1.getComments().addComment("comment1", pres.getSlides().get_Item(0), java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(10), java.newFloat(10)), java.newInstanceSync("java.util.Date"));
// Добавляет ответ к comment1
var author2 = pres.getCommentAuthors().addAuthor("Autror_2", "B.B.");
var reply1 = author2.getComments().addComment("reply 1 for comment 1", pres.getSlides().get_Item(0), java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(10), java.newFloat(10)), java.newInstanceSync("java.util.Date"));
reply1.setParentComment(comment1);
// Добавляет другой ответ к comment1
var reply2 = author2.getComments().addComment("reply 2 for comment 1", pres.getSlides().get_Item(0), java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(10), java.newFloat(10)), java.newInstanceSync("java.util.Date"));
reply2.setParentComment(comment1);
// Добавляет ответ к существующему ответу
var subReply = author1.getComments().addComment("subreply 3 for reply 2", pres.getSlides().get_Item(0), java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(10), java.newFloat(10)), java.newInstanceSync("java.util.Date"));
subReply.setParentComment(reply2);
var comment2 = author2.getComments().addComment("comment 2", pres.getSlides().get_Item(0), java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(10), java.newFloat(10)), java.newInstanceSync("java.util.Date"));
var comment3 = author2.getComments().addComment("comment 3", pres.getSlides().get_Item(0), java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(10), java.newFloat(10)), java.newInstanceSync("java.util.Date"));
var reply3 = author1.getComments().addComment("reply 4 for comment 3", pres.getSlides().get_Item(0), java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(10), java.newFloat(10)), java.newInstanceSync("java.util.Date"));
reply3.setParentComment(comment3);
// Выводит иерархию комментариев в консоль
var slide = pres.getSlides().get_Item(0);
var comments = slide.getSlideComments(null);
for (var i = 0; i < comments.length; i++) {
var comment = comments[i];
while (comment.getParentComment() != null) {
console.log("\t");
comment = comment.getParentComment();
}
console.log((comments[i].getAuthor().getName() + " : ") + comments[i].getText());
console.log();
}
pres.save("parent_comment.pptx", aspose.slides.SaveFormat.Pptx);
// Удаляет comment1 и все ответы к нему
comment1.remove();
pres.save("remove_comment.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
if (pres != null) {
pres.dispose();
}
}
Внимание
- Когда метод Remove (из класса Comment) используется для удаления комментария, ответы на комментарий также удаляются.
- Если настройка setParentComment приводит к циклической ссылке, будет выброшено исключение PptxEditException.
Добавить современный комментарий
В 2021 году Microsoft внедрила современные комментарии в PowerPoint. Функция современных комментариев значительно улучшает совместную работу в PowerPoint. С помощью современных комментариев пользователи PowerPoint могут разрешать комментарии, привязывать их к объектам и текстам и гораздо проще взаимодействовать.
В Aspose.Slides for Node.js via Java 21.11 мы реализовали поддержку современных комментариев, добавив класс ModernComment. Методы addModernComment и insertModernComment были добавлены в класс CommentCollection.
Этот код JavaScript показывает, как добавить современный комментарий к слайду в презентации PowerPoint:
var pres = new aspose.slides.Presentation();
try {
var newAuthor = pres.getCommentAuthors().addAuthor("Some Author", "SA");
var modernComment = newAuthor.getComments().addModernComment("This is a modern comment", pres.getSlides().get_Item(0), null, java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(100), java.newFloat(100)), java.newInstanceSync("java.util.Date"));
pres.save("pres.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
if (pres != null) {
pres.dispose();
}
}
Удалить комментарий
Удалить все комментарии и авторов
Этот код JavaScript показывает, как удалить все комментарии и авторов в презентации:
var presentation = new aspose.slides.Presentation("example.pptx");
try {
// Удаляет все комментарии из презентации
for (let i = 0; i < presentation.getCommentAuthors().size(); i++) {
var author = presentation.getCommentAuthors().get_Item(i)
author.getComments().clear();
}
// Удаляет всех авторов
presentation.getCommentAuthors().clear();
presentation.save("example_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
if (presentation != null) {
presentation.dispose();
}
}
Удалить определённые комментарии
Этот код JavaScript показывает, как удалить определённые комментарии на слайде:
var presentation = new aspose.slides.Presentation();
try {
var slide = presentation.getSlides().get_Item(0);
// добавить комментарии...
var author = presentation.getCommentAuthors().addAuthor("Author", "A");
author.getComments().addComment("comment 1", slide, java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(0.2), java.newFloat(0.2)), java.newInstanceSync("java.util.Date"));
author.getComments().addComment("comment 2", slide, java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(0.3), java.newFloat(0.2)), java.newInstanceSync("java.util.Date"));
// удалить все комментарии, содержащие текст "comment 1"
for (var i = 0; i < presentation.getCommentAuthors().length; i++) {
var commentAuthor = presentation.getCommentAuthors().get_Item(i);
var toRemove = java.newInstanceSync("java.util.ArrayList");
for (let j = 0; j < slide.getSlideComments(commentAuthor).size(); j++) {
let comment = slide.getSlideComments(commentAuthor).get_Item(j);
if (comment.getText() === "comment 1") {
toRemove.add(comment);
}
}
for (var i = 0; i < toRemove.length; i++) {
var comment = toRemove.get_Item(i);
commentAuthor.getComments().remove(comment);
}
}
presentation.save("pres.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
if (presentation != null) {
presentation.dispose();
}
}
Часто задаваемые вопросы
Поддерживает ли Aspose.Slides статус, например «решён», для современных комментариев?
Да. Modern comments предоставляют методы getStatus и setStatus; вы можете читать и задавать состояние комментария (например, пометить его как решённый), и это состояние сохраняется в файле и распознаётся PowerPoint.
Поддерживаются ли обсуждения в виде цепочек ответов и есть ли ограничение вложенности?
Да. Каждый комментарий может ссылаться на свой parent comment, что позволяет создавать произвольные цепочки ответов. API не задаёт конкретного ограничения глубины вложения.
В какой системе координат определяется позиция маркера комментария на слайде?
Позиция хранится как точка с плавающей запятой в системе координат слайда. Это позволяет точно разместить маркер комментария там, где это необходимо.