Aspose.Slides FOSS
C++
开发者指南
Comments and Notes

使用评论和演讲者备注 — Aspose.Slides FOSS for C++

Aspose.Slides FOSS for C++ supports two types of annotations: 线程式幻灯片评论 （在审阅模式下可见）并且 演讲者备注 （在演示者视图和备注窗格中可见）。.

线程式评论

评论附加到幻灯片并与作者关联。该 pres.comment_authors() 集合管理所有作者；每个作者都有一个 comments() 用于添加和读取评论的集合。.

添加评论 

#include <Aspose/Slides/Foss/comment.h>
#include <Aspose/Slides/Foss/comment_author.h>
#include <Aspose/Slides/Foss/comment_author_collection.h>
#include <Aspose/Slides/Foss/comment_collection.h>
#include <Aspose/Slides/Foss/drawing/point_f.h>
#include <Aspose/Slides/Foss/export/save_format.h>
#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/slide.h>
#include <Aspose/Slides/Foss/slide_collection.h>

#include <chrono>

using namespace Aspose::Slides::Foss;
using namespace Aspose::Slides::Foss::Drawing;

int main() {
    Presentation pres;

    // Create a comment author with initials
    auto& author = pres.comment_authors().add_author("Jane Smith", "JS");

    auto& slide = pres.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.0f, 2.0f),
        std::chrono::system_clock::now()
    );

    pres.save("commented.pptx", SaveFormat::PPTX);
    return 0;
}

该 PointF 位置以英寸为单位，测量自幻灯片左上角。可以通过调用来向同一幻灯片添加多个评论 add_comment() 再次。.

多个作者和评论 

#include <Aspose/Slides/Foss/comment_author.h>
#include <Aspose/Slides/Foss/comment_author_collection.h>
#include <Aspose/Slides/Foss/comment_collection.h>
#include <Aspose/Slides/Foss/drawing/point_f.h>
#include <Aspose/Slides/Foss/export/save_format.h>
#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/slide.h>
#include <Aspose/Slides/Foss/slide_collection.h>

#include <chrono>

using namespace Aspose::Slides::Foss;
using namespace Aspose::Slides::Foss::Drawing;

int main() {
    Presentation pres;
    auto& author1 = pres.comment_authors().add_author("Alice Brown", "AB");
    auto& author2 = pres.comment_authors().add_author("Bob Davis", "BD");

    auto& slide = pres.slides()[0];
    auto now = std::chrono::system_clock::now();

    author1.comments().add_comment("Initial draft", slide, PointF(1.0f, 1.0f), now);
    author2.comments().add_comment("Approved", slide, PointF(3.0f, 1.0f), now);

    pres.save("multi-author.pptx", SaveFormat::PPTX);
    return 0;
}

从现有文件读取评论 

#include <Aspose/Slides/Foss/comment_author.h>
#include <Aspose/Slides/Foss/comment_author_collection.h>
#include <Aspose/Slides/Foss/comment.h>
#include <Aspose/Slides/Foss/comment_collection.h>
#include <Aspose/Slides/Foss/presentation.h>

#include <iostream>

using namespace Aspose::Slides::Foss;

int main() {
    Presentation pres("commented.pptx");
    for (std::size_t i = 0; i < pres.comment_authors().size(); ++i) {
        auto& author = pres.comment_authors()[i];
        std::cout << "Author: " << author.name() << " (" << author.initials() << ")" << std::endl;
        for (std::size_t j = 0; j < author.comments().size(); ++j) {
            auto& comment = author.comments()[j];
            std::cout << "  " << comment.text() << std::endl;
        }
    }
    return 0;
}

演讲者备注

演讲者备注通过每张幻灯片的方式存储，使用一个 NotesSlide 对象。通过以下方式访问 slide.notes_slide_manager().

为幻灯片添加演讲者备注 

#include <Aspose/Slides/Foss/auto_shape.h>
#include <Aspose/Slides/Foss/export/save_format.h>
#include <Aspose/Slides/Foss/i_notes_slide.h>
#include <Aspose/Slides/Foss/i_notes_slide_manager.h>
#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/shape_collection.h>
#include <Aspose/Slides/Foss/shape_type.h>
#include <Aspose/Slides/Foss/slide.h>
#include <Aspose/Slides/Foss/slide_collection.h>
#include <Aspose/Slides/Foss/text_frame.h>

using namespace Aspose::Slides::Foss;

int main() {
    Presentation pres;
    auto& slide = pres.slides()[0];
    slide.shapes().add_auto_shape(ShapeType::RECTANGLE, 50, 50, 400, 200);

    // Create the notes slide and set text
    auto* notes = slide.notes_slide_manager().add_notes_slide();
    notes->notes_text_frame().set_text(
        "Mention the Q3 revenue increase on this slide. Emphasize the 24% growth.");

    pres.save("with-notes.pptx", SaveFormat::PPTX);
    return 0;
}

检查是否已存在备注幻灯片

notes_slide_manager().notes_slide() 返回 nullptr 如果尚未创建备注幻灯片：:

#include <Aspose/Slides/Foss/i_notes_slide.h>
#include <Aspose/Slides/Foss/i_notes_slide_manager.h>
#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/slide.h>
#include <Aspose/Slides/Foss/slide_collection.h>
#include <Aspose/Slides/Foss/text_frame.h>

#include <iostream>

using namespace Aspose::Slides::Foss;

int main() {
    Presentation pres("existing.pptx");
    for (std::size_t i = 0; i < pres.slides().size(); ++i) {
        auto* existing_notes = pres.slides()[i].notes_slide_manager().notes_slide();
        if (existing_notes) {
            auto text = existing_notes->notes_text_frame().text();
            std::cout << "Slide " << (i + 1) << " notes: " << text.substr(0, 60) << "..." << std::endl;
        } else {
            std::cout << "Slide " << (i + 1) << ": no notes" << std::endl;
        }
    }
    return 0;
}

另请参阅

 中文