在 Python 中管理簡報註解

概述

本文說明如何在 Aspose.Slides 中管理簡報註解。它會展示與註解相關的主要類型，並示範如何在投影片中加入註解、存取現有註解、處理回覆、使用現代註解以及從簡報中移除註解。

範例聚焦於 PowerPoint 中常見的審閱與協作情境，例如為作者指派註解、讀取註解內容與中繼資料、建立回覆鏈，以及清除全部註解或刪除特定註解。

在 PowerPoint 中，註解會顯示為投影片上的備註或標註。點擊註解時，會顯示其內容或訊息。

為何要在簡報中加入註解？

在審閱簡報時，您可能希望使用註解提供回饋或與同事溝通。

為了讓您在 PowerPoint 簡報中使用註解，Aspose.Slides for Python via .NET 提供

[Presentation]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/presentation/）類別，包含作者集合（來自 [CommentAuthorCollection]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/commentauthorcollection/）屬性）。作者會將註解加入投影片。
[CommentCollection]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/commentcollection/）類別，包含個別作者的註解集合。
[Comment]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/comment/）類別，包含關於作者與其註解的資訊：誰加入了註解、加入時間、註解位置等。
[CommentAuthor]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/commentauthor/）類別，包含單一作者的資訊：作者名稱、縮寫、與該作者相關的註解等。

加入投影片註解

以下 Python 程式碼示範如何在 PowerPoint 簡報的投影片中加入註解：

import aspose.slides as slides
import aspose.pydrawing as draw
import datetime

# 實例化 Presentation 類別
with slides.Presentation() as presentation:
    # 新增空白投影片
    presentation.slides.add_empty_slide(presentation.layout_slides[0])

    # 新增作者
    author = presentation.comment_authors.add_author("Jawad", "MF")

    # 設定註解的位置
    point = draw.PointF(0.2, 0.2)

    # 為作者在投影片 1 上新增投影片註解
    author.comments.add_comment("Hello Jawad, this is slide comment", presentation.slides[0], point, datetime.date.today())

    # 為作者在投影片 2 上新增投影片註解
    author.comments.add_comment("Hello Jawad, this is second slide comment", presentation.slides[1], point, datetime.date.today())

    # 存取 ISlide 1
    slide = presentation.slides[0]

    # 當參數傳入 null 時，會將所有作者的註解帶入選取的投影片
    comments = slide.get_slide_comments(author)

    # 取得投影片 1 索引 0 的註解
    str = comments[0].text

    presentation.save("Comments_out.pptx", slides.export.SaveFormat.PPTX)

    if comments.length > 0:
        # 選取作者索引 0 的註解集合
        commentCollection = comments[0].author.comments
        print(commentCollection[0].text)

存取投影片註解

以下 Python 程式碼示範如何存取 PowerPoint 簡報投影片上已存在的註解：

import aspose.slides as slides

# 實例化 Presentation 類別
with slides.Presentation("Comments1.pptx") as presentation:
    for author in presentation.comment_authors:
        for comment in author.comments:
            print("ISlide :" + str(comment.slide.slide_number) + 
            " has comment: " + comment.text + 
            " with Author: " + comment.author.name + 
            " posted on time :" + str(comment.created_time) + "\n")

回覆註解

父註解是階層中最高層或原始的註解。使用 [Comment]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/comment/）類別的 parent_comment 屬性，您可以設定或取得父註解。

以下 Python 程式碼示範如何加入註解並取得其回覆：

import aspose.slides as slides
import aspose.pydrawing as draw
import datetime

with slides.Presentation() as pres:
    # 新增註解
    author1 = pres.comment_authors.add_author("Author_1", "A.A.")
    comment1 = author1.comments.add_comment("comment1", pres.slides[0], draw.PointF(10, 10), datetime.date.today())

    # 為 comment1 新增回覆
    author2 = pres.comment_authors.add_author("Autror_2", "B.B.")
    reply1 = author2.comments.add_comment("reply 1 for comment 1", pres.slides[0], draw.PointF(10, 10), datetime.date.today())
    reply1.parent_comment = comment1

    # 為 comment1 再新增一次回覆
    reply2 = author2.comments.add_comment("reply 2 for comment 1", pres.slides[0], draw.PointF(10, 10), datetime.date.today())
    reply2.parent_comment = comment1

    # 為既有回覆新增回覆
    subReply = author1.comments.add_comment("subreply 3 for reply 2", pres.slides[0], draw.PointF(10, 10), datetime.date.today())
    subReply.parent_comment = reply2

    comment2 = author2.comments.add_comment("comment 2", pres.slides[0], draw.PointF(10, 10), datetime.date.today())
    comment3 = author2.comments.add_comment("comment 3", pres.slides[0], draw.PointF(10, 10), datetime.date.today())

    reply3 = author1.comments.add_comment("reply 4 for comment 3", pres.slides[0], draw.PointF(10, 10), datetime.date.today())
    reply3.parent_comment = comment3

    # 在主控台顯示註解階層
    slide = pres.slides[0]
    comments = slide.get_slide_comments(None)
    for i in range(comments.length):
        comment = comments[i]
        while comment.parent_comment is not None:
            print("\t")
            comment = comment.parent_comment

        print(comments[i].author.name + " : " + comments[i].text)
        print("\r\n")

    pres.save("parent_comment.pptx", slides.export.SaveFormat.PPTX)

    # 移除 comment1 以及其所有回覆
    comment1.remove()

    pres.save("remove_comment.pptx", slides.export.SaveFormat.PPTX)

注意

當使用 [Comment]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/comment/）類別的 remove 方法刪除註解時，該註解的回覆也會被一併刪除。
如果 parent_comment 設定導致循環參照，會拋出 PptxEditException。

加入現代註解

2021 年，Microsoft 在 PowerPoint 中引入 現代註解。現代註解功能大幅提升了 PowerPoint 的協作體驗。透過現代註解，使用者可以解決註解、將註解錨定於物件或文字，並更輕鬆地進行互動。

我們透過加入 [ModernComment]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/moderncomment/）類別來支援現代註解，並在 [CommentCollection]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/commentcollection/）類別中新增 add_modern_comment 與 insert_modern_comment 方法。

以下 Python 程式碼示範如何在 PowerPoint 簡報的投影片中加入現代註解：

import aspose.pydrawing as draw
import aspose.slides as slides
from datetime import date

with slides.Presentation() as pres:
    newAuthor = pres.comment_authors.add_author("Some Author", "SA")
    modernComment = newAuthor.comments.add_modern_comment("This is a modern comment", pres.slides[0], None, draw.PointF(100, 100), date.today())

    pres.save("example.pptx", slides.export.SaveFormat.PPTX)

移除註解

刪除全部註解與作者

以下 Python 程式碼示範如何移除簡報中所有的註解與作者：

import aspose.slides as slides

with slides.Presentation("example.pptx") as presentation:
    # 刪除簡報中所有註解
    for author in presentation.comment_authors:
        author.comments.clear()

    # 刪除所有作者
    presentation.comment_authors.clear()

    presentation.save("example_out.pptx", slides.export.SaveFormat.PPTX)

刪除特定註解

以下 Python 程式碼示範如何刪除投影片上特定的註解：

import aspose.pydrawing as draw
import aspose.slides as slides
from datetime import date

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    
    # 新增註解...
    author = presentation.comment_authors.add_author("Author", "A")
    author.comments.add_comment("comment 1", slide, draw.PointF(0.2, 0.2), date.today())
    author.comments.add_comment("comment 2", slide, draw.PointF(0.3, 0.2), date.today())
    
    # 移除所有包含「comment 1」文字的註解
    for commentAuthor in presentation.comment_authors:
        toRemove = []
        for comment in slide.get_slide_comments(commentAuthor):
            if comment.text == "comment 1":
                toRemove.append(comment)
        
        for comment in toRemove:
            commentAuthor.comments.remove(comment)
    
    presentation.save("pres.pptx", slides.export.SaveFormat.PPTX)

常見問題

Aspose.Slides 是否支援現代註解的「已解決」狀態？

是的。[Modern comments]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/moderncomment/）提供 status 屬性；您可以讀取與設定 [comment 的狀態]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/moderncommentstatus/）(例如標記為已解決)，此狀態會儲存在檔案中並被 PowerPoint 辨識。

是否支援串列討論（回覆鏈），且有巢狀深度限制嗎？

是的。每個註解都可以參照其 [parent comment]（https://reference.aspose.com/slides/zh-hant/python-net/aspose.slides/moderncomment/parent_comment/），允許任意深度的回覆鏈。API 未宣告特定的巢狀深度上限。

註解標記在投影片上的位置是以哪種座標系統定義的？

位置以浮點座標點儲存在投影片的座標系統中，使您能夠精確地將註解標記放置在需要的位置。

在 Python 中檢索與更新簡報檢視屬性在 Python 中管理簡報備註