Comments and Notes

Làm việc với Bình luận và Ghi chú Diễn giả — Aspose.Slides FOSS for Python

Aspose.Slides FOSS for Python hỗ trợ hai loại chú thích: threaded slide comments (hiển thị trong chế độ xem xét) và speaker notes (hiển thị trong Presenter View và khung Notes).

Bình luận dạng chuỗi

Bình luận được gắn vào một slide và liên kết với một tác giả. Bộ sưu tập prs.comment_authors quản lý tất cả các tác giả; mỗi tác giả có một bộ sưu tập comments để thêm và đọc bình luận.

Thêm bình luận

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 initials
    author = prs.comment_authors.add_author("Jane Smith", "JS")

    slide = prs.slides[0]

    # Add a comment at position (2.0, 2.0) inches from the slide top-left
    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)

Vị trí PointF được tính bằng inch từ góc trên‑trái của slide. Nhiều bình luận có thể được thêm vào cùng một slide bằng cách gọi add_comment() một lần nữa.

Nhiều tác giả và bình luận

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", slide, PointF(1.0, 1.0), datetime.now())
    author2.comments.add_comment("Approved", slide, PointF(3.0, 1.0), datetime.now())

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

Đọc bình luận từ tệp hiện có

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"  [{comment.slide.slide_number}] {comment.text}")

Ghi chú người thuyết trình

Ghi chú người nói được lưu trữ trên cơ sở mỗi slide thông qua đối tượng NotesSlide. Truy cập nó qua slide.notes_slide_manager.

Thêm Ghi chú Diễn giả vào Slide

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(slides.ShapeType.RECTANGLE, 50, 50, 400, 200)

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

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

Ví dụ Ghi chú Đơn giản hơn

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, 100, 100, 500, 250).add_text_frame("Main Content")

    notes = slide.notes_slide_manager.add_notes_slide()
    notes.notes_text_frame.text = "These are the speaker notes for this slide."

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

Kiểm tra xem một slide ghi chú đã tồn tại chưa

notes_slide_manager.notes_slide trả về None nếu chưa có slide ghi chú nào được tạo.

import aspose.slides_foss as slides

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

Thêm ghi chú cho nhiều slide

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

note_texts = [
    "Opening remarks: introduce the agenda.",
    "Key metrics: emphasize Q4 results.",
    "Closing: call to action.",
]

with slides.Presentation() as prs:
    # Add slides 2 and 3
    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)