Spravovat komentáře v prezentaci v Pythonu přes Java

O čem je tato stránka

Spravujte komentáře v prezentaci pomocí Aspose.Slides pro Python přes Java: přidávejte, čtěte, upravujte, odpovídejte na a odstraňujte komentáře v PowerPoint prezentacích rychle a snadno.

Přehled

Tento článek vysvětluje, jak spravovat poznámky v prezentaci pomocí Aspose.Slides pro Python prostřednictvím Javy. Představuje hlavní typy související s poznámkami a ukazuje, jak přidávat poznámky do snímků, přistupovat k existujícím poznámkám, pracovat s odpověďmi a moderními poznámkami a odstraňovat poznámky z prezentace.

Příklady pokrývají běžné scénáře revize a spolupráce v PowerPointu, jako je přiřazování poznámek autorům, čtení textu a metadat poznámek, vytváření řetězců odpovědí a odstraňování vybraných poznámek nebo všech poznámek.

V PowerPointu se poznámky zobrazují jako anotace na snímcích. Vybrání poznámky zobrazí její text a související diskusi.

Chcete-li požádat, aby byly při otevření prezentace poznámky zobrazeny nebo skryty, aniž byste měnili samotné poznámky, viz Show or Hide Comments When Opening a Presentation.

Proč přidávat poznámky do prezentací?

Můžete použít poznámky k poskytování zpětné vazby a spolupráci s kolegy při revizi prezentací.

Aspose.Slides pro Python prostřednictvím Javy poskytuje následující API pro práci s poznámkami:

Třída Presentation, která poskytuje přístup k autorům poznámek v prezentaci.
Třída CommentCollection, která představuje poznámky přiřazené konkrétnímu autorovi.
Třída Comment, která poskytuje informace o poznámce, včetně jejího autora, času vytvoření, polohy a textu.
Třída CommentAuthor, která poskytuje informace o autorovi, včetně jeho jména, iniciál a přiřazených poznámek.

Přidání poznámek do snímků

Následující příklad ukazuje, jak přidat poznámky do snímků v prezentaci PowerPoint:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

Point2DFloat = jpype.JClass("java.awt.geom.Point2D$Float")
Date = jpype.JClass("java.util.Date")

presentation = Presentation()
try:
    first_slide = presentation.getSlides().get_Item(0)
    second_slide = presentation.getSlides().addEmptySlide(presentation.getLayoutSlides().get_Item(0))
    author = presentation.getCommentAuthors().addAuthor("Jawad", "MF")
    position = Point2DFloat(0.2, 0.2)
    created_time = Date()

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

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

        author_comments = first_comment.getAuthor().getComments()
        comment_text = author_comments.get_Item(0).getText()
        print(comment_text)

    presentation.save("Comments_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Přístup k poznámkám ve snímcích

Následující příklad ukazuje, jak přistupovat k existujícím poznámkám v prezentaci PowerPoint:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("Comments1.pptx")
try:
    for author in presentation.getCommentAuthors():
        for comment in author.getComments():
            print("Slide: ", comment.getSlide().getSlideNumber())
            print("Comment: ", comment.getText())
            print("Author: ", comment.getAuthor().getName())
            print("Posted at: ", comment.getCreatedTime())
            print()
finally:
    presentation.dispose()

Odpověď na poznámky

Rodičovská poznámka je originální poznámka na vrcholu hierarchie odpovědí. Metody Comment.getParentComment a Comment.setParentComment umožňují získat nebo nastavit rodiče poznámky.

Následující příklad ukazuje, jak přidat odpovědi a prozkoumat vzniklou hierarchii poznámek:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

Point2DFloat = jpype.JClass("java.awt.geom.Point2D$Float")
Date = jpype.JClass("java.util.Date")

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    position = Point2DFloat(10, 10)
    created_time = Date()

    thread_author = presentation.getCommentAuthors().addAuthor("Author_1", "A.A.")
    root_comment = thread_author.getComments().addComment("comment 1", slide, position, created_time)

    responding_author = presentation.getCommentAuthors().addAuthor("Author_2", "B.B.")
    direct_reply = responding_author.getComments().addComment("reply 1 for comment 1", slide, position, created_time)
    direct_reply.setParentComment(root_comment)

    branch_reply = responding_author.getComments().addComment("reply 2 for comment 1", slide, position, created_time)
    branch_reply.setParentComment(root_comment)

    nested_reply = thread_author.getComments().addComment("subreply 3 for reply 2", slide, position, created_time)
    nested_reply.setParentComment(branch_reply)

    responding_author.getComments().addComment("comment 2", slide, position, created_time)
    separate_thread_comment = responding_author.getComments().addComment("comment 3", slide, position, created_time)

    separate_thread_reply = thread_author.getComments().addComment("reply 4 for comment 3", slide, position, created_time)
    separate_thread_reply.setParentComment(separate_thread_comment)

    comments = slide.getSlideComments(None)
    for i in range(len(comments)):
        comment = comments[i]
        while comment.getParentComment() is not None:
            print("\t", end="")
            comment = comment.getParentComment()

        print(f"{comments[i].getAuthor().getName()}: {comments[i].getText()}")

    presentation.save("parent_comment.pptx", SaveFormat.Pptx)

    root_comment.remove()
    presentation.save("remove_comment.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Warning

Když je použita metoda Comment.remove k odstranění poznámky, jsou také smazány všechny odpovědi na tuto poznámku.
Pokud metoda Comment.setParentComment vytvoří kruhový odkaz, je vyhozena výjimka PptxEditException.

Přidání moderních poznámek

Moderní poznámky mohou být přiřazeny přímo ke snímku, k určitému tvaru nebo k textovému úseku uvnitř AutoShape. Metoda CommentCollection.addModernComment přijímá jako argument kromě snímku a souřadnic značky poznámky také objekt Shape.

Když je pro argument shape předáno None, jedná se o poznámku na úrovni snímku. Její značka je umístěna podle zadaných souřadnic, ale není spojena s konkrétním tvarem, takže ModernComment.getShape vrací None. Když je předán objekt [Shape], je poznámka ukotvena k tomuto tvaru. Souřadnice i nadále určují pozici značky poznámky na snímku, zatímco asociaci s tvarem lze získat pomocí ModernComment.getShape.

Ukotvení moderní poznámky na tvar

Následující příklad vytvoří jak moderní poznámku na úrovni snímku, tak moderní poznámku ukotvenou ke konkrétnímu AutoShape. Poté přečte přiřazený tvar u každé poznámky.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, ShapeType

Point2DFloat = jpype.JClass("java.awt.geom.Point2D$Float")
Date = jpype.JClass("java.util.Date")

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    author = presentation.getCommentAuthors().addAuthor("Reviewer", "RV")
    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 300, 80)
    shape.setName("Revenue title")
    shape.getTextFrame().setText("Quarterly revenue")

    created_time = Date()
    slide_comment_position = Point2DFloat(20, 20)
    shape_comment_position = Point2DFloat(60, 60)
    slide_comment = author.getComments().addModernComment("Review the overall slide layout.", slide, None, slide_comment_position, created_time)
    shape_comment = author.getComments().addModernComment("Check this title.", slide, shape, shape_comment_position, created_time)

    print(slide_comment.getShape() is None)
    print(shape_comment.getShape().getName())

    presentation.save("modern_comments.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Ukotvení poznámek k různým typům tvarů

Jakýkoli objekt snímku, který dědí z třídy Shape, může být použit jako kotva tvaru. Běžné příklady zahrnují AutoShape, PictureFrame, GroupShape, Connector a instance GraphicalObject, například grafy.

Následující příklad vytvoří několik běžných typů tvarů a přiřadí k nim moderní poznámku.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ChartType, Presentation, SaveFormat, ShapeType

Point2DFloat = jpype.JClass("java.awt.geom.Point2D$Float")
Date = jpype.JClass("java.util.Date")
Base64 = jpype.JClass("java.util.Base64")

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    author = presentation.getCommentAuthors().addAuthor("Reviewer", "RV")
    created_time = Date()

    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 180, 60)
    auto_shape.getTextFrame().setText("AutoShape")
    auto_shape_comment_position = Point2DFloat(30, 30)
    author.getComments().addModernComment("Comment on an AutoShape.", slide, auto_shape, auto_shape_comment_position, created_time)

    image_base64 = "iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAAFklEQVR4nGP8//8/AwMDEwMDAwMDAwAkBgMB/DXemwAAAABJRU5ErkJggg=="
    image_data = Base64.getDecoder().decode(image_base64)
    image = presentation.getImages().addImage(image_data)
    picture_frame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 220, 20, 120, 80, image)
    picture_comment_position = Point2DFloat(230, 30)
    author.getComments().addModernComment("Comment on a picture.", slide, picture_frame, picture_comment_position, created_time)

    group_shape = slide.getShapes().addGroupShape()
    group_shape.getShapes().addAutoShape(ShapeType.Rectangle, 0, 0, 80, 40)
    group_shape.getShapes().addAutoShape(ShapeType.Ellipse, 100, 0, 80, 40)
    group_comment_position = Point2DFloat(40, 150)
    author.getComments().addModernComment("Comment on a group.", slide, group_shape, group_comment_position, created_time)

    connector = slide.getShapes().addConnector(ShapeType.StraightConnector1, 220, 150, 140, 40)
    connector_comment_position = Point2DFloat(240, 150)
    author.getComments().addModernComment("Comment on a connector.", slide, connector, connector_comment_position, created_time)

    chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 400, 20, 250, 180)
    chart_comment_position = Point2DFloat(420, 40)
    author.getComments().addModernComment("Comment on a graphical object.", slide, chart, chart_comment_position, created_time)

    presentation.save("modern_comment_shape_types.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Ukotvení poznámky k textu a nastavení jejího stavu

Pro moderní poznámku přiřazenou k AutoShape umožňují metody ModernComment.getTextSelectionStart a ModernComment.setTextSelectionStart získat počáteční pozici vybraného textu v textovém rámci tvaru. Metody ModernComment.getTextSelectionLength a ModernComment.setTextSelectionLength získávají délku výběru. Společně tyto hodnoty přiřazují poznámku ke konkrétnímu textovému úseku uvnitř AutoShape.

Metody ModernComment.getStatus a ModernComment.setStatus přistupují k hodnotě z konstant ModernCommentStatus:

[NotDefined] — není definován žádný konkrétní stav moderní poznámky.
[Active] — poznámka je aktivní.
[Resolved] — poznámka byla vyřešena.
[Closed] — poznámka je uzavřena.

Následující příklad vytvoří moderní poznámku ukotvenou k tvaru, přiřadí ji k výběru textu, označí ji jako vyřešenou, uloží prezentaci a po znovuotevření souboru ověří hodnoty.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ModernComment, ModernCommentStatus, Presentation, SaveFormat, ShapeType

Point2DFloat = jpype.JClass("java.awt.geom.Point2D$Float")
Date = jpype.JClass("java.util.Date")

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

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 400, 100)
    shape.setName("Forecast text")
    shape.getTextFrame().setText(shape_text)

    author = presentation.getCommentAuthors().addAuthor("Reviewer", "RV")
    comment_position = Point2DFloat(60, 60)
    created_time = Date()
    comment = author.getComments().addModernComment("Verify this forecast wording.", slide, shape, comment_position, created_time)
    comment.setTextSelectionStart(expected_selection_start)
    comment.setTextSelectionLength(len(selected_text))
    comment.setStatus(ModernCommentStatus.Resolved)

    presentation.save(output_file, SaveFormat.Pptx)
finally:
    presentation.dispose()

reopened_presentation = Presentation(output_file)
try:
    reopened_slide = reopened_presentation.getSlides().get_Item(0)
    reopened_comments = reopened_slide.getSlideComments(None)

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

        modern_comment = reopened_comment
        shape_matches = modern_comment.getShape() is not None and modern_comment.getShape().getName() == "Forecast text"
        selection_start_matches = modern_comment.getTextSelectionStart() == expected_selection_start
        selection_length_matches = modern_comment.getTextSelectionLength() == len(selected_text)
        status_matches = modern_comment.getStatus() == ModernCommentStatus.Resolved

        print("Shape anchor preserved: ", shape_matches)
        print("Text selection start preserved: ", selection_start_matches)
        print("Text selection length preserved: ", selection_length_matches)
        print("Resolved status preserved: ", status_matches)
finally:
    reopened_presentation.dispose()

Prohlížení existujících moderních poznámek

Pro prohlédnutí existující prezentace zjistěte, které poznámky jsou instance ModernComment, poté prověřte ModernComment.getShape, ModernComment.getTextSelectionStart, ModernComment.getTextSelectionLength a ModernComment.getStatus. None jako tvar označuje poznámku na úrovni snímku. Pro kotvu na [AutoShape] je metoda výběru textu schopna identifikovat příslušný úsek v textovém rámci tvaru.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import AutoShape, ModernComment, Presentation

presentation = Presentation("comments.pptx")
try:
    for slide in presentation.getSlides():
        comments = slide.getSlideComments(None)
        for comment in comments:
            if not isinstance(comment, ModernComment):
                continue

            modern_comment = comment
            print("Slide: ", slide.getSlideNumber())
            print("Text: ", modern_comment.getText())
            print("Status: ", modern_comment.getStatus())

            shape = modern_comment.getShape()
            if shape is None:
                print("Anchor: slide level")
            else:
                print("Anchor shape: ", shape.getName())
                print("Anchor type: ", shape.getClass().getSimpleName())

                if isinstance(shape, AutoShape):
                    print("Text selection start: ", modern_comment.getTextSelectionStart())
                    print("Text selection length: ", modern_comment.getTextSelectionLength())

            print()
finally:
    presentation.dispose()

Odstranění poznámek

Odstranění všech poznámek a autorů poznámek

Následující příklad ukazuje, jak odstranit všechny poznámky a autory poznámek z prezentace:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("example.pptx")
try:
    for author in presentation.getCommentAuthors():
        author.getComments().clear()

    presentation.getCommentAuthors().clear()
    presentation.save("example_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Odstranění konkrétních poznámek

Následující příklad ukazuje, jak odstranit konkrétní poznámky ze snímku:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

Point2DFloat = jpype.JClass("java.awt.geom.Point2D$Float")
Date = jpype.JClass("java.util.Date")

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    author = presentation.getCommentAuthors().addAuthor("Author", "A")
    created_time = Date()

    first_comment_position = Point2DFloat(0.2, 0.2)
    second_comment_position = Point2DFloat(0.3, 0.2)
    author.getComments().addComment("comment 1", slide, first_comment_position, created_time)
    author.getComments().addComment("comment 2", slide, second_comment_position, created_time)

    for comment_author in presentation.getCommentAuthors():
        comments_to_remove = []
        comments = slide.getSlideComments(comment_author)

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

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

    presentation.save("pres.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Často kladené otázky

Podporuje Aspose.Slides stav „vyřešeno“ pro moderní poznámky?

Ano. Metody ModernComment.getStatus a ModernComment.setStatus přistupují k hodnotě z ModernCommentStatus, včetně Resolved. Stav je uložen v prezentaci a lze jej po opětovném otevření souboru znovu načíst.

Jsou podporovány vlákna diskuzí (řetězce odpovědí) a existuje limit hloubky vnoření?

Ano. Každá poznámka může odkazovat na svou parent comment, což umožňuje řetězce odpovědí. API nedefinuje konkrétní limit hloubky vnoření.

V jakém souřadnicovém systému je definována pozice značky poznámky na snímku?

Pozice značky je definována pomocí souřadnic s plovoucí desetinnou čárkou v souřadnicovém systému snímku, což umožňuje její přesné umístění na snímku.

Načíst a aktualizovat vlastnosti zobrazení prezentace v Pythonu pomocí Javy Správa poznámek prezentace v Pythonu přes Java