Pythonでプレゼンテーションコメントを管理

このページの概要

Aspose.Slides for Python via .NET を使用して PowerPoint プレゼンテーションのコメントを管理します。コメントの追加、読み取り、編集、返信、削除が可能です。

概要

この記事では、Aspose.Slides for Python via .NET を使用してプレゼンテーションのコメントを管理する方法を説明します。主なコメント関連型を紹介し、スライドにコメントを追加する方法、既存のコメントにアクセスする方法、返信やモダンコメントを操作する方法、プレゼンテーションからコメントを削除する方法をデモンストレーションします。

例では、PowerPoint の一般的なレビューおよび共同作業シナリオ、たとえばコメントを作者に割り当てること、コメント本文とメタデータを読み取ること、返信チェーンを構築すること、選択したコメントやすべてのコメントを削除すること、を取り上げます。

PowerPoint では、コメントはスライド上の注釈として表示されます。コメントを選択すると、そのテキストと関連するディスカッションが表示されます。

プレゼンテーションを開くときにコメントを表示または非表示にするには、コメント自体を変更せずに設定できます。プレゼンテーションを開くときにコメントを表示または非表示にする.

なぜプレゼンテーションにコメントを追加するのか？

プレゼンテーションをレビューする際、コメントを使用してフィードバックを提供し、同僚と協働できます。

Aspose.Slides for Python via .NET は、コメント操作のために以下の API を提供します:

Presentation クラスは、プレゼンテーションのコメント作成者へのアクセスを提供します。
CommentCollection クラスは、個々の作者に関連付けられたコメントを表します。
Comment クラスは、コメントに関する情報（作者、作成時刻、位置、テキスト）を提供します。
CommentAuthor クラスは、作者に関する情報（名前、イニシャル、関連コメント）を提供します。

スライドコメントの追加

以下の例では、PowerPoint プレゼンテーションのスライドにコメントを追加する方法を示します。

from datetime import datetime

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

with slides.Presentation() as presentation:
    first_slide = presentation.slides[0]
    second_slide = presentation.slides.add_empty_slide(presentation.layout_slides[0])
    author = presentation.comment_authors.add_author("Jawad", "MF")
    position = draw.PointF(0.2, 0.2)
    created_time = datetime.now()

    author.comments.add_comment("Hello Jawad, this is a slide comment", first_slide, position, created_time)
    author.comments.add_comment("Hello Jawad, this is the second slide comment", second_slide, position, created_time)

    comments = first_slide.get_slide_comments(author)
    if len(comments) > 0:
        first_comment = comments[0]
        print(first_comment.text)

        comment_text = first_comment.author.comments[0].text
        print(comment_text)

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

スライドコメントへのアクセス

以下の例では、PowerPoint プレゼンテーション内の既存のコメントにアクセスする方法を示します。

import aspose.slides as slides

with slides.Presentation("Comments1.pptx") as presentation:
    for author in presentation.comment_authors:
        for comment in author.comments:
            print("Slide: " + str(comment.slide.slide_number))
            print("Comment: " + comment.text)
            print("Author: " + comment.author.name)
            print("Posted at: " + str(comment.created_time))
            print()

コメントへの返信

親コメントは、返信階層のトップにある元のコメントです。Comment クラスの parent_comment プロパティを使用すると、コメントの親を取得または設定できます。

以下の例では、返信を追加し、生成されたコメント階層を調べる方法を示します。

from datetime import datetime

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

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    position = draw.PointF(10, 10)
    created_time = datetime.now()

    author1 = presentation.comment_authors.add_author("Author_1", "A.A.")
    comment1 = author1.comments.add_comment("comment 1", slide, position, created_time)

    author2 = presentation.comment_authors.add_author("Author_2", "B.B.")
    reply1 = author2.comments.add_comment("reply 1 for comment 1", slide, position, created_time)
    reply1.parent_comment = comment1

    reply2 = author2.comments.add_comment("reply 2 for comment 1", slide, position, created_time)
    reply2.parent_comment = comment1

    sub_reply = author1.comments.add_comment("subreply 3 for reply 2", slide, position, created_time)
    sub_reply.parent_comment = reply2

    author2.comments.add_comment("comment 2", slide, position, created_time)
    comment3 = author2.comments.add_comment("comment 3", slide, position, created_time)

    reply3 = author1.comments.add_comment("reply 4 for comment 3", slide, position, created_time)
    reply3.parent_comment = comment3

    comments = slide.get_slide_comments(None)
    for current_comment in comments:
        comment = current_comment
        while comment.parent_comment is not None:
            print("\t", end="")
            comment = comment.parent_comment

        print(current_comment.author.name + ": " + current_comment.text)

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

    comment1.remove()
    presentation.save("remove_comment.pptx", slides.export.SaveFormat.PPTX)

Warning

[Comment] クラスの remove メソッドを使用してコメントを削除すると、そのコメントへのすべての返信も削除されます。
parent_comment プロパティが循環参照を作成した場合、PptxEditException がスローされます。

モダンコメントの追加

モダンコメントは、スライド自体、特定のシェイプ、または AutoShape 内のテキスト範囲に関連付けることができます。CommentCollection.add_modern_comment メソッドは、スライドとコメントマーカー座標に加えて Shape 引数を受け取ります。

None が shape 引数に渡された場合、コメントはスライドレベルのコメントになります。マーカーは指定された座標で配置されますが、特定のシェイプには関連付けられないため、ModernComment.shape は None を返します。Shape が指定されると、コメントはそのシェイプにアンカー付けされます。座標は依然としてスライド上のコメントマーカーの位置を定義し、シェイプとの関連は ModernComment.shape から取得できます。

シェイプにモダンコメントをアンカー付け

以下の例では、スライドレベルのモダンコメントと特定の AutoShape にアンカー付けされたモダンコメントの両方を作成し、各コメントから対応するシェイプを取得します。

from datetime import datetime

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

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    author = presentation.comment_authors.add_author("Reviewer", "RV")
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 300, 80)
    shape.name = "Revenue title"
    shape.text_frame.text = "Quarterly revenue"

    created_time = datetime.now()
    slide_comment_position = draw.PointF(20, 20)
    shape_comment_position = draw.PointF(60, 60)
    slide_comment = author.comments.add_modern_comment("Review the overall slide layout.", slide, None, slide_comment_position, created_time)
    shape_comment = author.comments.add_modern_comment("Check this title.", slide, shape, shape_comment_position, created_time)

    print(slide_comment.shape is None)
    print(shape_comment.shape.name)

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

異なるシェイプタイプへのコメントのアンカー付け

Shape から派生した任意のスライドオブジェクトはシェイプアンカーとして使用できます。一般的な例として、AutoShape、PictureFrame、GroupShape、Connector、および GraphicalObject（チャートなど）のインスタンスがあります。

以下の例では、いくつかの一般的なシェイプタイプを作成し、各シェイプにモダンコメントを関連付けます。

import base64
from datetime import datetime

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

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    author = presentation.comment_authors.add_author("Reviewer", "RV")
    created_time = datetime.now()

    auto_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 180, 60)
    auto_shape.text_frame.text = "AutoShape"
    auto_shape_comment_position = draw.PointF(30, 30)
    author.comments.add_modern_comment("Comment on an AutoShape.", slide, auto_shape, auto_shape_comment_position, created_time)

    image_base64 = "iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAAFklEQVR4nGP8//8/AwMDEwMDAwMDAwAkBgMB/DXemwAAAABJRU5ErkJggg=="
    image_data = base64.b64decode(image_base64)
    image = presentation.images.add_image(image_data)
    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 220, 20, 120, 80, image)
    picture_comment_position = draw.PointF(230, 30)
    author.comments.add_modern_comment("Comment on a picture.", slide, picture_frame, picture_comment_position, created_time)

    group_shape = slide.shapes.add_group_shape()
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 0, 0, 80, 40)
    group_shape.shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 100, 0, 80, 40)
    group_comment_position = draw.PointF(40, 150)
    author.comments.add_modern_comment("Comment on a group.", slide, group_shape, group_comment_position, created_time)

    connector = slide.shapes.add_connector(slides.ShapeType.STRAIGHT_CONNECTOR1, 220, 150, 140, 40)
    connector_comment_position = draw.PointF(240, 150)
    author.comments.add_modern_comment("Comment on a connector.", slide, connector, connector_comment_position, created_time)

    chart = slide.shapes.add_chart(slides.charts.ChartType.CLUSTERED_COLUMN, 400, 20, 250, 180)
    chart_comment_position = draw.PointF(420, 40)
    author.comments.add_modern_comment("Comment on a graphical object.", slide, chart, chart_comment_position, created_time)

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

テキストにコメントをアンカー付けしステータスを設定

AutoShape に関連付けられたモダンコメントの場合、ModernComment.text_selection_start はシェイプのテキストフレーム内で選択されたテキストの開始位置を示し、ModernComment.text_selection_length は選択範囲の長さを示します。これらのプロパティを組み合わせることで、コメントは AutoShape 内の特定のテキスト範囲に関連付けられます。

ModernComment.status プロパティは、ModernCommentStatus 列挙体の値で読み取りまたは更新できます。

NOT_DEFINED — 特定のモダンコメントステータスは定義されていません。
ACTIVE — コメントはアクティブです。
RESOLVED — コメントは解決済みです。
CLOSED — コメントはクローズされています。

以下の例では、シェイプにアンカー付けされたモダンコメントを作成し、テキスト選択に関連付け、解決済みとしてマークし、プレゼンテーションを保存し、ファイルを再度開いた後に値を検証します。

from datetime import datetime

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

output_file = "modern_comment_text_anchor.pptx"
shape_text = "Review the quarterly revenue forecast."
selected_text = "quarterly revenue"
expected_selection_start = shape_text.index(selected_text)

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 400, 100)
    shape.name = "Forecast text"
    shape.text_frame.text = shape_text

    author = presentation.comment_authors.add_author("Reviewer", "RV")
    comment_position = draw.PointF(60, 60)
    comment = author.comments.add_modern_comment("Verify this forecast wording.", slide, shape, comment_position, datetime.now())
    comment.text_selection_start = expected_selection_start
    comment.text_selection_length = len(selected_text)
    comment.status = slides.ModernCommentStatus.RESOLVED

    presentation.save(output_file, slides.export.SaveFormat.PPTX)

with slides.Presentation(output_file) as reopened_presentation:
    reopened_slide = reopened_presentation.slides[0]
    reopened_comments = reopened_slide.get_slide_comments(None)

    for reopened_comment in reopened_comments:
        if not isinstance(reopened_comment, slides.ModernComment):
            continue

        shape_matches = reopened_comment.shape.name == "Forecast text"
        selection_start_matches = reopened_comment.text_selection_start == expected_selection_start
        selection_length_matches = reopened_comment.text_selection_length == len(selected_text)
        status_matches = reopened_comment.status == slides.ModernCommentStatus.RESOLVED

        print("Shape anchor preserved: " + str(shape_matches))
        print("Text selection start preserved: " + str(selection_start_matches))
        print("Text selection length preserved: " + str(selection_length_matches))
        print("Resolved status preserved: " + str(status_matches))

既存のモダンコメントの検査

既存のプレゼンテーションを検査するには、どのコメントが ModernComment インスタンスであるかを確認し、次に ModernComment.shape、ModernComment.text_selection_start、ModernComment.text_selection_length、および ModernComment.status を調べます。None のシェイプはスライドレベルのコメントを示します。AutoShape のアンカーの場合、テキスト選択プロパティはシェイプのテキストフレーム内の対象範囲を示します。

import aspose.slides as slides

with slides.Presentation("comments.pptx") as presentation:
    for slide in presentation.slides:
        comments = slide.get_slide_comments(None)
        for comment in comments:
            if not isinstance(comment, slides.ModernComment):
                continue

            print("Slide: " + str(slide.slide_number))
            print("Text: " + comment.text)
            print("Status: " + str(comment.status))

            shape = comment.shape
            if shape is None:
                print("Anchor: slide level")
            else:
                print("Anchor shape: " + shape.name)
                print("Anchor type: " + type(shape).__name__)

                if isinstance(shape, slides.AutoShape):
                    print("Text selection start: " + str(comment.text_selection_start))
                    print("Text selection length: " + str(comment.text_selection_length))

            print()

コメントの削除

すべてのコメントとコメント作者の削除

以下の例では、プレゼンテーションからすべてのコメントとコメント作者を削除する方法を示します。

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)

特定のコメントの削除

以下の例では、スライドから特定のコメントを削除する方法を示します。

from datetime import datetime

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

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    author = presentation.comment_authors.add_author("Author", "A")
    created_time = datetime.now()

    first_comment_position = draw.PointF(0.2, 0.2)
    second_comment_position = draw.PointF(0.3, 0.2)
    author.comments.add_comment("comment 1", slide, first_comment_position, created_time)
    author.comments.add_comment("comment 2", slide, second_comment_position, created_time)

    for comment_author in presentation.comment_authors:
        comments_to_remove = []
        comments = slide.get_slide_comments(comment_author)

        for comment in comments:
            if comment.text == "comment 1":
                comments_to_remove.append(comment)

        for comment in comments_to_remove:
            comment_author.comments.remove(comment)

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

よくある質問

Aspose.Slides はモダンコメントの解決ステータスをサポートしていますか？

はい。ModernComment.status は、RESOLVED を含む ModernCommentStatus の値で読み取りおよび設定できます。このステータスはプレゼンテーションに保存され、ファイルを再度開いた後でも再度読み取ることができます。

スレッド化されたディスカッション（返信チェーン）はサポートされていますか？また、ネストの上限はありますか？

はい。各コメントは parent comment を参照できるため、返信チェーンが可能です。API では特定のネスト深さの上限は定義されていません。

コメントマーカーの位置はスライド上でどの座標系で定義されていますか？

マーカーの位置はスライド座標系の浮動小数点座標で定義されており、スライド上の任意の位置に正確に配置できます。

Python でプレゼンテーションのビュープロパティを取得および更新する Pythonでプレゼンテーションノートを管理