演示文稿批注

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

为什么要在演示文稿中添加批注？

在审阅演示文稿时，您可能希望使用批注提供反馈或与同事进行交流。

为了让您在 PowerPoint 演示文稿中使用批注，Aspose.Slides for .NET 提供

  • Presentation 类，其中包含作者集合（来自 CommentAuthorCollection 属性）。作者向幻灯片添加批注。
  • ICommentCollection 接口，包含单个作者的批注集合。
  • IComment 类，包含作者及其批注的信息：谁添加了批注、批注添加的时间、批注的位置等。
  • CommentAuthor 类，包含单个作者的信息：作者姓名、缩写、与该作者关联的批注等。

添加幻灯片批注

以下 C# 代码演示了如何在 PowerPoint 演示文稿的幻灯片中添加批注：

// 实例化 Presentation 类
using (Presentation presentation = new Presentation())
{
    // 添加空幻灯片
    presentation.Slides.AddEmptySlide(presentation.LayoutSlides[0]);

    // 添加作者
    ICommentAuthor author = presentation.CommentAuthors.AddAuthor("Jawad", "MF");

    // 设置批注的位置
    PointF point = new PointF();
    point.X = 0.2f;
    point.Y = 0.2f;

    // 为作者在幻灯片 1 上添加幻灯片批注
    author.Comments.AddComment("Hello Jawad, this is slide comment", presentation.Slides[0], point, DateTime.Now);

    // 为作者在幻灯片 2 上添加幻灯片批注
    author.Comments.AddComment("Hello Jawad, this is second slide comment", presentation.Slides[1], point, DateTime.Now);

    // 访问 ISlide 1
    ISlide slide = presentation.Slides[0];

    // 当参数为 null 时，将所有作者的批注带到选定的幻灯片
    IComment[] Comments = slide.GetSlideComments(author);

    // 访问幻灯片 1 上索引为 0 的批注
    String str = Comments[0].Text;

    presentation.Save("Comments_out.pptx", SaveFormat.Pptx);

    if (Comments.GetLength(0) > 0)
    {
        // 选择索引为 0 的作者批注集合
        ICommentCollection commentCollection = Comments[0].Author.Comments;
        String Comment = commentCollection[0].Text;
    }
}

访问幻灯片批注

以下 C# 代码演示了如何访问 PowerPoint 演示文稿中幻灯片的现有批注：

// 实例化 Presentation 类
using (Presentation presentation = new Presentation("Comments1.pptx"))
{
    foreach (var commentAuthor in presentation.CommentAuthors)
    {
        var author = (CommentAuthor) commentAuthor;
        foreach (var comment1 in author.Comments)
        {
            var comment = (Comment) comment1;
            Console.WriteLine("ISlide :" + comment.Slide.SlideNumber + " has comment: " + comment.Text + " with Author: " + comment.Author.Name + " posted on time :" + comment.CreatedTime + "\n");
        }
    }
}

回复批注

父批注是层级结构中顶层或原始批注。使用来自 IComment 接口的 ParentComment 属性，您可以设置或获取父批注。

以下 C# 代码演示了如何添加批注并获取其回复：

using (Presentation pres = new Presentation())
{
    // 添加批注
    ICommentAuthor author1 = pres.CommentAuthors.AddAuthor("Author_1", "A.A.");
    IComment comment1 = author1.Comments.AddComment("comment1", pres.Slides[0], new PointF(10, 10), DateTime.Now);

    // 为 comment1 添加回复
    ICommentAuthor author2 = pres.CommentAuthors.AddAuthor("Autror_2", "B.B.");
    IComment reply1 = author2.Comments.AddComment("reply 1 for comment 1", pres.Slides[0], new PointF(10, 10), DateTime.Now);
    reply1.ParentComment = comment1;

    // 为 comment1 添加另一个回复
    IComment reply2 = author2.Comments.AddComment("reply 2 for comment 1", pres.Slides[0], new PointF(10, 10), DateTime.Now);
    reply2.ParentComment = comment1;

    // 为已有回复添加回复
    IComment subReply = author1.Comments.AddComment("subreply 3 for reply 2", pres.Slides[0], new PointF(10, 10), DateTime.Now);
    subReply.ParentComment = reply2;

    IComment comment2 = author2.Comments.AddComment("comment 2", pres.Slides[0], new PointF(10, 10), DateTime.Now);
    IComment comment3 = author2.Comments.AddComment("comment 3", pres.Slides[0], new PointF(10, 10), DateTime.Now);

    IComment reply3 = author1.Comments.AddComment("reply 4 for comment 3", pres.Slides[0], new PointF(10, 10), DateTime.Now);
    reply3.ParentComment = comment3;

    // 在控制台显示批注层次结构
    ISlide slide = pres.Slides[0];
    var comments = slide.GetSlideComments(null);
    for (int i = 0; i < comments.Length; i++)
    {
        IComment comment = comments[i];
        while (comment.ParentComment != null)
        {
            Console.Write("\t");
            comment = comment.ParentComment;
        }

        Console.Write("{0} : {1}", comments[i].Author.Name, comments[i].Text);
        Console.WriteLine();
    }

    pres.Save("parent_comment.pptx",SaveFormat.Pptx);

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

    pres.Save("remove_comment.pptx", SaveFormat.Pptx);
}

添加现代批注

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

在 Aspose Slides for .NET 21.11 中，我们通过添加 ModernComment 类实现了对现代批注的支持。向 CommentCollection 类添加了 AddModernComment 和 InsertModernComment 方法。

以下 C# 代码演示了如何在 PowerPoint 演示文稿的幻灯片中添加现代批注：

using (Presentation pres = new Presentation())
{
     ICommentAuthor newAuthor = pres.CommentAuthors.AddAuthor("Some Author", "SA");
     IModernComment modernComment = newAuthor.Comments.AddModernComment("This is a modern comment", pres.Slides[0], null, new PointF(100, 100), DateTime.Now);
 
     pres.Save("pres.pptx", SaveFormat.Pptx);
}

删除批注

删除所有批注和作者

以下 C# 代码演示了如何删除演示文稿中的所有批注和作者：

using (var presentation = new Presentation("example.pptx"))
{
    // 删除演示文稿中的所有批注
    foreach (var author in presentation.CommentAuthors)
    {
        author.Comments.Clear();
    }

    // 删除所有作者
    presentation.CommentAuthors.Clear();

    presentation.Save("example_out.pptx", SaveFormat.Pptx);
}

删除特定批注

以下 C# 代码演示了如何删除幻灯片上的特定批注：

using (var presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];
    
    // 添加批注...
    ICommentAuthor author = presentation.CommentAuthors.AddAuthor("Author", "A");
    author.Comments.AddComment("comment 1", slide, new PointF(0.2f, 0.2f), DateTime.Now);
    author.Comments.AddComment("comment 2", slide, new PointF(0.3f, 0.2f), DateTime.Now);
    
    // 删除所有包含 "comment 1" 文本的批注
    foreach (ICommentAuthor commentAuthor in presentation.CommentAuthors)
    {
        List<IComment> toRemove = new List<IComment>();
        foreach (IComment comment in slide.GetSlideComments(commentAuthor))
        {
            if (comment.Text == "comment 1")
            {
                toRemove.Add(comment);
            }
        }
        
        foreach (IComment comment in toRemove)
        {
            commentAuthor.Comments.Remove(comment);
        }
    }
    
    presentation.Save("pres.pptx", SaveFormat.Pptx);
}

常见问题

Aspose.Slides 是否支持现代批注的“已解决”状态？

是的。 Modern comments 暴露了 Status 属性；您可以读取和设置批注的状态（例如标记为已解决），该状态会保存在文件中并被 PowerPoint 识别。

是否支持线程化讨论（回复链），以及是否有嵌套层级限制？

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

批注标记在幻灯片上的位置使用哪种坐标系定义？

位置以浮点坐标点存储在幻灯片的坐标系中。这使您能够精确地将批注标记放置在所需位置。

演示文稿视图属性 演示文稿备注