Como adicionar comentários ao PowerPoint no Python

Este guia mostra como adicionar comentários e notas de orador a slides do PowerPoint usando Aspose.Slides FOSS para Python. Use prs.comment_authors.add_author() para criar um autor, em seguida, chamar author.comments.add_comment() para anexar comentários com thread a um slide. Use slide.notes_slide_manager.add_notes_slide() para adicionar notas de alto-falante por diapositiva.

Precondições

Instale a biblioteca no seu ambiente Python executando o seguinte comando pip antes de executar qualquer exemplo:

pip install aspose-slides-foss

Adicionar um Comentário

As observações pertencem a um Autor: Objeto. Crie um autor primeiro, em seguida adicione comentários através de author.comments:

from aspose.slides_foss.drawing import PointF
from datetime import datetime
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    # Create a comment author with name and initials
    author = prs.comment_authors.add_author("Jane Smith", "JS")

    slide = prs.slides[0]

    # Add a comment at (2.0, 2.0) inches from the slide top-left corner
    author.comments.add_comment(
        "Please review the figures on this slide",
        slide,
        PointF(2.0, 2.0),
        datetime.now(),
    )

    prs.save("commented.pptx", SaveFormat.PPTX)

A Comissão PointF Coordenadas estão em: centímetros Vários chamadas para o “Slide” e a chamada de “Call to Slide”. add_comment() criar uma cadeia de comentários com o mesmo autor.

Vários autores e comentários

Criar vários autores com: prs.comment_authors.add_author() e anexar observações separadas de cada uma delas:

from aspose.slides_foss.drawing import PointF
from datetime import datetime
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    author1 = prs.comment_authors.add_author("Alice Brown", "AB")
    author2 = prs.comment_authors.add_author("Bob Davis", "BD")

    slide = prs.slides[0]

    author1.comments.add_comment(
        "Initial draft: needs revision",
        slide, PointF(1.0, 1.0), datetime.now()
    )
    author2.comments.add_comment(
        "Approved after changes",
        slide, PointF(3.0, 1.0), datetime.now()
    )

    prs.save("multi-author.pptx", SaveFormat.PPTX)

Leia comentários de um arquivo existente

Carregar o ficheiro em um Presentation, iterar prs.comment_authors, e para cada autor iterar author.comments para ler o texto e a referência do diapositivo:

import aspose.slides_foss as slides

with slides.Presentation("commented.pptx") as prs:
    for author in prs.comment_authors:
        print(f"Author: {author.name} ({author.initials})")
        for comment in author.comments:
            print(f"  Slide {comment.slide.slide_number}: {comment.text}")

Adicionar notas de orador a um slide

As notas do orador são adicionadas ao chamar o slide.notes_slide_manager.add_notes_slide(), depois escrever texto para o notes.notes_text_frame.text:

from aspose.slides_foss import ShapeType
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    slide.shapes.add_auto_shape(
        ShapeType.RECTANGLE, 50, 50, 600, 300
    ).add_text_frame("Main slide content")

    # Create the notes slide and write text
    notes = slide.notes_slide_manager.add_notes_slide()
    notes.notes_text_frame.text = (
        "Mention the Q3 revenue increase. Emphasize the 24% YoY growth."
    )

    prs.save("with-notes.pptx", SaveFormat.PPTX)

Adicionar notas a vários slides

Iterar mais prs.slides E chama-me. slide.notes_slide_manager.add_notes_slide() para cada diapositiva, anexar uma nota numa única passagem:

from aspose.slides_foss import ShapeType
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

note_texts = [
    "Opening: introduce the agenda and set expectations.",
    "Key metrics: emphasize Q4 results and growth trajectory.",
    "Closing: summarize and call to action.",
]

with slides.Presentation() as prs:
    layout = prs.slides[0].layout_slide
    prs.slides.add_empty_slide(layout)
    prs.slides.add_empty_slide(layout)

    for i, slide in enumerate(prs.slides):
        slide.shapes.add_auto_shape(
            ShapeType.RECTANGLE, 50, 50, 600, 300
        ).add_text_frame(f"Slide {i + 1}")

        n = slide.notes_slide_manager.add_notes_slide()
        n.notes_text_frame.text = note_texts[i]

    prs.save("all-notes.pptx", SaveFormat.PPTX)

Verifique se as notas já existem

notes_slide_manager.notes_slide Renda de rendimentos None se não tiver sido criado nenhum diapositivo de notas:

import aspose.slides_foss as slides

with slides.Presentation("existing.pptx") as prs:
    for i, slide in enumerate(prs.slides):
        existing = slide.notes_slide_manager.notes_slide
        if existing:
            print(f"Slide {i + 1}: {existing.notes_text_frame.text[:60]}")
        else:
            print(f"Slide {i + 1}: no notes")