使用 C++ 管理演示文稿评论

在 PowerPoint 中，评论显示为幻灯片上的备注或注释。单击评论后，其内容或信息会显示出来。

为什么要在演示文稿中添加评论？

在审阅演示文稿时，您可能希望使用评论来提供反馈或与同事交流。

为了让您在 PowerPoint 演示文稿中使用评论，Aspose.Slides for C++ 提供

  • The Presentation 类，包含作者集合（来自 get_CommentAuthors() 方法）。作者向幻灯片添加评论。
  • The ICommentCollection 接口，包含针对各个作者的评论集合。
  • The IComment 类，包含关于作者及其评论的信息：谁添加了评论、添加评论的时间、评论的位置等。
  • The CommentAuthor 类，包含关于单个作者的信息：作者姓名、其首字母缩写、与作者姓名关联的评论等。

添加幻灯片评论

此 C++ 代码演示如何向 PowerPoint 演示文稿的幻灯片添加评论：

// 实例化 Presentation 类
auto presentation = System::MakeObject<Presentation>();
// 添加空幻灯片
presentation->get_Slides()->AddEmptySlide(presentation->get_LayoutSlides()->idx_get(0));

// 添加作者
auto author = presentation->get_CommentAuthors()->AddAuthor(u"Jawad", u"MF");

// 设置评论的位置
PointF point;
point.set_X(0.2f);
point.set_Y(0.2f);

// 访问 ISlide 1
auto slide1 = presentation->get_Slides()->idx_get(0);
// 访问 ISlide 2
auto slide2 = presentation->get_Slides()->idx_get(1);

// 为作者在幻灯片 1 上添加幻灯片评论
author->get_Comments()->AddComment(u"Hello Jawad, this is slide comment", slide1, point, DateTime::get_Now());

// 为作者在幻灯片 2 上添加幻灯片评论
author->get_Comments()->AddComment(u"Hello Jawad, this is second slide comment", slide2, point, DateTime::get_Now());

// 当参数为 null 时，将所有作者的评论带到选定的幻灯片
auto comments = slide1->GetSlideComments(author);

// 访问索引 0 处的评论
String str = comments[0]->get_Text();

presentation->Save(u"Comments_out.pptx", SaveFormat::Pptx);

if (comments->GetLength(0) > 0)
{
    // 选择索引 0 处的作者评论集合
    auto commentCollection = comments[0]->get_Author()->get_Comments();
    String Comment = commentCollection->idx_get(0)->get_Text();
}

访问幻灯片评论

此 C++ 代码演示如何访问 PowerPoint 演示文稿中幻灯片上的现有评论：

// 实例化 Presentation 类
auto presentation = System::MakeObject<Presentation>(u"Comments1.pptx");

for (auto&& commentAuthor : presentation->get_CommentAuthors())
{
    auto author = System::ExplicitCast<CommentAuthor>(commentAuthor);
    for (auto&& comment1 : System::IterateOver(author->get_Comments()))
    {
        SmartPtr<Comment> comment = System::ExplicitCast<Comment>(comment1);
        Console::WriteLine(String(u"ISlide :")
                        + comment->get_Slide()->get_SlideNumber()
                        + u" has comment: " + comment->get_Text()
                        + u" with Author: " + comment->get_Author()->get_Name()
                        + u" posted on time :" + comment->get_CreatedTime() + u"\n");
    }
}

回复评论

父级评论是评论或回复层级中的顶层或原始评论。使用 ParentComment 属性（来自 IComment 接口），您可以设置或获取父级评论。

此 C++ 代码演示如何添加评论并获取其回复：

auto pres = System::MakeObject<Presentation>();

// 访问 ISlide 1
auto slide1 = pres->get_Slides()->idx_get(0);

// 添加评论
auto author1 = pres->get_CommentAuthors()->AddAuthor(u"Author_1", u"A.A.");
auto comment1 = author1->get_Comments()->AddComment(u"comment1", slide1, PointF(10.0f, 10.0f), DateTime::get_Now());

// 向 comment1 添加回复
auto author2 = pres->get_CommentAuthors()->AddAuthor(u"Autror_2", u"B.B.");
auto reply1 = author2->get_Comments()->AddComment(u"reply 1 for comment 1", slide1, PointF(10.0f, 10.0f), DateTime::get_Now());
reply1->set_ParentComment(comment1);

// 再向 comment1 添加一个回复
auto reply2 = author2->get_Comments()->AddComment(u"reply 2 for comment 1", slide1, PointF(10.0f, 10.0f), DateTime::get_Now());
reply2->set_ParentComment(comment1);

// 向已有回复添加回复
auto subReply = author1->get_Comments()->AddComment(u"subreply 3 for reply 2", slide1, PointF(10.0f, 10.0f), DateTime::get_Now());
subReply->set_ParentComment(reply2);

auto comment2 = author2->get_Comments()->AddComment(u"comment 2", slide1, PointF(10.0f, 10.0f), DateTime::get_Now());
auto comment3 = author2->get_Comments()->AddComment(u"comment 3", slide1, PointF(10.0f, 10.0f), DateTime::get_Now());

auto reply3 = author1->get_Comments()->AddComment(u"reply 4 for comment 3", slide1, PointF(10.0f, 10.0f), DateTime::get_Now());
reply3->set_ParentComment(comment3);

// 在控制台显示评论层级
auto comments = slide1->GetSlideComments(nullptr);
for (int32_t i = 0; i < comments->get_Length(); i++)
{
    auto comment = comments[i];
    while (comment->get_ParentComment() != nullptr)
    {
        Console::Write(u"\t");
        comment = comment->get_ParentComment();
    }

    Console::Write(u"{0} : {1}", comments[i]->get_Author()->get_Name(), comments[i]->get_Text());
    Console::WriteLine();
}

pres->Save(u"parent_comment.pptx", SaveFormat::Pptx);

// 删除 comment1 及其所有回复
comment1->Remove();

pres->Save(u"remove_comment.pptx", SaveFormat::Pptx);

添加现代评论

2021 年，Microsoft 在 PowerPoint 中引入了现代评论。现代评论功能显著提升了 PowerPoint 的协作能力。通过现代评论，PowerPoint 用户可以解决评论、将评论锚定到对象和文本上，并且能够更轻松地进行交互。

在 Aspose Slides for C++ 21.11 中，我们通过添加 ModernComment 类实现了对现代评论的支持。向 CommentCollection 类新增了 AddModernComment 和 InsertModernComment 方法。

此 C++ 代码演示如何向 PowerPoint 演示文稿的幻灯片添加现代评论：

auto pres = System::MakeObject<Presentation>();
// 访问 ISlide 1
auto slide1 = pres->get_Slides()->idx_get(0);

auto newAuthor = pres->get_CommentAuthors()->AddAuthor(u"Some Author", u"SA");
auto modernComment = newAuthor->get_Comments()->AddModernComment(u"This is a modern comment", slide1, nullptr, PointF(100.0f, 100.0f), DateTime::get_Now());

pres->Save(u"pres.pptx", SaveFormat::Pptx);

删除评论

删除所有评论和作者

此 C++ 代码演示如何在演示文稿中删除所有评论和作者：

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System::Drawing;

auto presentation = System::MakeObject<Presentation>(u"example.pptx");

// 删除演示文稿中的所有评论
for (auto author : presentation->get_CommentAuthors())
{
    author->get_Comments()->Clear();
}
        
// 删除所有作者
presentation->get_CommentAuthors()->Clear();
presentation->Save(u"example_out.pptx", SaveFormat::Pptx);

删除特定评论

此 C++ 代码演示如何删除幻灯片上的特定评论：

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System::Drawing;

auto presentation = System::MakeObject<Presentation>();
auto slide = presentation->get_Slides()->idx_get(0);
        
// 添加评论...
auto author = presentation->get_CommentAuthors()->AddAuthor(u"Author", u"A");
author->get_Comments()->AddComment(u"comment 1", slide, PointF(0.2f, 0.2f), System::DateTime::get_Now());
author->get_Comments()->AddComment(u"comment 2", slide, PointF(0.3f, 0.2f), System::DateTime::get_Now());
        
// 删除所有包含 "comment 1" 文本的评论
for (auto commentAuthor : presentation->get_CommentAuthors())
{
    auto toRemove = System::MakeObject<System::Collections::Generic::List<System::SharedPtr<IComment>>>();
    for (auto comment : slide->GetSlideComments(commentAuthor))
    {
        if (comment->get_Text() == u"comment 1")
        {
            toRemove->Add(comment);
        }
    }
    for (auto comment : toRemove)
    {
        commentAuthor->get_Comments()->Remove(comment);
    }
}
        
presentation->Save(u"pres.pptx", SaveFormat::Pptx);

常见问题

Aspose.Slides 是否支持现代评论的“已解决”等状态？

是的。Modern comments 提供了 get_Status 和 set_Status 方法；您可以读取和设置 评论的状态（例如，将其标记为已解决），该状态会保存到文件中，并被 PowerPoint 识别。

是否支持线程式讨论（回复链），并且是否有嵌套层级限制？

是的。每条评论都可以引用其 parent comment，从而实现任意的回复链。API 并未声明具体的嵌套深度限制。

评论标记在幻灯片上的位置采用哪种坐标系定义？

位置以浮点坐标点存储在幻灯片的坐标系中。这样您可以精确地将评论标记放置在所需位置。

在 C++ 中检索并更新演示文稿视图属性 管理 C++ 演示文稿备注