Prezentációs megjegyzések kezelése Pythonban

Miről szól ez az oldal

Prezentációs megjegyzések kezelése az Aspose.Slides for Python via .NET segítségével: megjegyzések hozzáadása, olvasása, szerkesztése, megválaszolása és eltávolítása PowerPoint prezentációkban.

Áttekintés

Ez a cikk bemutatja, hogyan kezelhetőek a prezentáció megjegyzései az Aspose.Slides for Python via .NET segítségével. Bemutatja a megjegyzésekkel kapcsolatos fő típusokat, és megmutatja, hogyan adhatunk megjegyzéseket a diákhoz, hogyan érhetjük el a meglévő megjegyzéseket, hogyan dolgozhatunk válaszokkal és modern megjegyzésekkel, valamint hogyan távolíthatunk el megjegyzéseket egy prezentációból.

A példák a PowerPointban gyakran előforduló felülvizsgálati és együttműködési forgatókönyveket fedik le, például a megjegyzések szerzőhöz rendelését, a megjegyzés szövegének és metaadatainak olvasását, a válaszláncok felépítését, valamint a kiválasztott vagy az összes megjegyzés eltávolítását.

PowerPointben a megjegyzések annotációként jelennek meg a diákon. Egy megjegyzés kiválasztása megjeleníti annak szövegét és a kapcsolódó vitát.

Miért érdemes megjegyzéseket hozzáadni a prezentációkhoz?

Megjegyzéseket használhat a visszajelzésnyújtáshoz és a kollégákkal való együttműködéshez a prezentációk felülvizsgálata során.

Az Aspose.Slides for Python via .NET a következő API-kat kínálja a megjegyzésekkel való munkához:

A Presentation osztály, amely hozzáférést biztosít a prezentáció megjegyzésíróihoz.
A CommentCollection osztály, amely egy adott szerzőhöz tartozó megjegyzéseket képviseli.
A Comment osztály, amely információkat szolgáltat egy megjegyzésről, beleértve a szerzőt, létrehozási időt, pozíciót és a szöveget.
A CommentAuthor osztály, amely információkat ad egy szerzőről, beleértve a nevét, kezdőbetűit és a kapcsolódó megjegyzéseket.

Diamegjegyzések hozzáadása

Az alábbi példa megmutatja, hogyan lehet megjegyzéseket hozzáadni egy PowerPoint‑prezentáció diáihoz:

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)

Diamegjegyzések elérése

Az alábbi példa bemutatja, hogyan érhetők el a meglévő megjegyzések egy PowerPoint‑prezentációban:

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()

Válasz a megjegyzésekre

A szülő megjegyzés a válaszhierarchia tetején lévő eredeti megjegyzés. A Comment osztály parent_comment tulajdonsága lehetővé teszi a szülő megjegyzés lekérését vagy beállítását.

Az alábbi példa megmutatja, hogyan adhatunk válaszokat, és hogyan vizsgálhatjuk meg a keletkezett megjegyzés‑hierarchiát:

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

Amikor a Comment osztály remove metódusát használják egy megjegyzés törlésére, a megjegyzéshez tartozó összes válasz is törlésre kerül.
Ha a parent_comment tulajdonság körkörös hivatkozást hoz létre, akkor egy PptxEditException kerül dobásra.

Modern megjegyzések hozzáadása

Modern megjegyzések a diára, egy adott alakzatra vagy egy AutoShape‑on belüli szövegtartományra is hivatkozhatók. A CommentCollection.add_modern_comment metódus egy Shape argumentumot is elfogad a dia és a megjegyzés‑jelölő koordinátái mellett.

Amikor a shape argumentumként None kerül átadásra, a megjegyzés dia‑szintű megjegyzés lesz. Jelölője a megadott koordinátákkal helyezkedik el, de nincs hozzárendelve konkrét alakzathoz, ezért a ModernComment.shape None‑t ad vissza. Ha egy Shape kerül megadásra, a megjegyzés ahhoz az alakzathoz lesz rögzítve. A koordináták továbbra is a megjegyzés jelölő pozícióját határozzák meg a dián, míg az alakzati hozzárendelést a ModernComment.shape szolgáltatja.

Modern megjegyzés rögzítése egy alakzatra

Az alábbi példa létrehoz egy dia‑szintű modern megjegyzést és egy konkrét AutoShape‑hoz rögzített modern megjegyzést, majd mindkét megjegyzéshez lekéri a hozzárendelt alakzatot.

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)

Megjegyzések rögzítése különböző alakzat típusokra

Bármely, a Shape osztályból származó diaobjektum használható alakzat‑horgonyként. Gyakori példák a AutoShape, a PictureFrame, a GroupShape, a Connector és a GraphicalObject példányok, például diagramok.

Az alábbi példa több gyakori alakzat típust hoz létre, és mindegyikhez modern megjegyzést társít.

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)

Megjegyzés rögzítése szöveghez és állapot beállítása

Egy modern megjegyzés, amely egy AutoShape-hez van társítva, a ModernComment.text_selection_start a kijelölt szöveg kezdőpozícióját adja meg az alakzat szövegkeretében, míg a ModernComment.text_selection_length a kijelölés hosszát határozza meg. Ezek a tulajdonságok együtt a megjegyzést egy adott szövegtartományra kötik az AutoShape‑on belül.

A ModernComment.status tulajdonság olvasható vagy módosítható a ModernCommentStatus felsorolás egy értékével:

NOT_DEFINED — nincs meghatározott modern‑megjegyzés állapot.
ACTIVE — a megjegyzés aktív.
RESOLVED — a megjegyzés megoldott.
CLOSED — a megjegyzés lezárt.

Az alábbi példa egy alakzatra rögzített modern megjegyzést hoz létre, szövegkijelöléshez társítja, megoldottnak jelöli, elmenti a prezentációt, majd a fájl újranyitása után ellenőrzi az értékeket.

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))

Meglévő modern megjegyzések vizsgálata

Egy meglévő prezentáció vizsgálatához ellenőrizze, hogy mely megjegyzések ModernComment példányok, majd vizsgálja meg a ModernComment.shape, a ModernComment.text_selection_start, a ModernComment.text_selection_length és a ModernComment.status tulajdonságokat. Egy None alakzat dia‑szintű megjegyzést jelez. Egy AutoShape horgony esetén a szövegkijelölés‑tulajdonságok az alakzat szövegkeretében lévő tartományt határozzák meg.

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()

Megjegyzések eltávolítása

Minden megjegyzés és megjegyzés‑szerző eltávolítása

Az alábbi példa megmutatja, hogyan távolíthatók el az összes megjegyzés és megjegyzés‑szerző a prezentációból:

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)

Különleges megjegyzések eltávolítása

Az alábbi példa bemutatja, hogyan távolíthatók el konkrét megjegyzések egy diáról:

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)

GYIK

Támogatja-e az Aspose.Slides a modern megjegyzések „megoldott” állapotát?

Igen. A ModernComment.status olvasható és beállítható egy ModernCommentStatus értékkel, beleértve a RESOLVED‑t is. Az állapot a prezentációban tárolódik, és a fájl újranyitása után újból lekérhető.

Támogatottak-e a szálas beszélgetések (válaszláncok), és van‑e mélységkorlát?

Igen. Minden megjegyzés hivatkozhat a parent comment‑re, lehetővé téve a válaszláncokat. Az API nem határoz meg konkrét mélységkorlátot.

Milyen koordináta‑rendszerben van meghatározva egy megjegyzés‑jelölő pozíciója a dián?

A jelölő pozíciója lebegőpontos koordinátákkal van megadva a dia koordináta‑rendszerében, ami lehetővé teszi a pontos elhelyezést a dián.

Prezentációs nézet tulajdonságok lekérése és frissítése Pythonban Prezentációs jegyzetek kezelése Pythonban