كيفية إضافة تعليقات إلى PowerPoint باستخدام C++
يدعم Aspose.Slides FOSS لـ C++ آليتين للتعليق:
- Threaded comments: مرفقة بشريحة في موضع محدد، وتظهر في لوحة المراجعة في PowerPoint
- Speaker notes: نص لكل شريحة يظهر في وضع Presenter View ولوحة Notes pane
المتطلبات المسبقة
git clone https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
cd Aspose.Slides-FOSS-for-Cpp && mkdir build && cd build
cmake .. && cmake --build .أضف تعليق
التعليقات تنتمي إلى كائن المؤلف. أنشئ مؤلفًا أولاً، ثم أضف التعليقات عبر author.comments():
#include <Aspose/Slides/Foss/presentation.h>
#include <chrono>
int main() {
namespace asf = Aspose::Slides::Foss;
asf::Presentation prs;
// Create a comment author with name and initials
auto& author = prs.comment_authors().add_author("Jane Smith", "JS");
auto& slide = prs.slides()[0];
// Add a comment at position (2.0, 2.0) from the slide top-left
Aspose::Slides::Foss::Drawing::PointF pos(2.0f, 2.0f);
author.comments().add_comment(
"Please review the figures on this slide",
slide, pos, std::chrono::system_clock::now());
prs.save("commented.pptx", asf::SaveFormat::PPTX);
return 0;
}الإحداثيات PointF هي بالبوصة من أعلى اليسار للشرائح. عدة استدعاءات لـ add_comment() تخلق سلسلة تعليقات متسلسلة تحت نفس المؤلف.
مؤلفون متعددون وتعليقات
#include <Aspose/Slides/Foss/presentation.h>
int main() {
namespace asf = Aspose::Slides::Foss;
asf::Presentation prs;
auto& author1 = prs.comment_authors().add_author("Alice Brown", "AB");
auto& author2 = prs.comment_authors().add_author("Bob Davis", "BD");
auto& slide = prs.slides()[0];
author1.comments().add_comment(
"Initial draft: needs revision",
slide, Aspose::Slides::Foss::Drawing::PointF(1.0f, 1.0f), std::chrono::system_clock::now());
author2.comments().add_comment(
"Approved after changes",
slide, Aspose::Slides::Foss::Drawing::PointF(3.0f, 1.0f), std::chrono::system_clock::now());
prs.save("multi-author.pptx", asf::SaveFormat::PPTX);
return 0;
}قراءة التعليقات من ملف موجود
#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>
int main() {
namespace asf = Aspose::Slides::Foss;
asf::Presentation prs("commented.pptx");
for (size_t i = 0; i < prs.comment_authors().size(); ++i) {
auto& author = prs.comment_authors()[i];
std::cout << "Author: " << author.name()
<< " (" << author.initials() << ")\n";
for (size_t j = 0; j < author.comments().size(); ++j) {
auto& comment = author.comments()[j];
std::cout << " Slide " << comment.slide().slide_number()
<< ": " << comment.text() << "\n";
}
}
return 0;
}إضافة ملاحظات المتحدث إلى شريحة
يتم إضافة ملاحظات المتحدث من خلال slide.notes_slide_manager():
#include <Aspose/Slides/Foss/presentation.h>
int main() {
namespace asf = Aspose::Slides::Foss;
asf::Presentation prs;
auto& slide = prs.slides()[0];
auto& main_shape = slide.shapes().add_auto_shape(
asf::ShapeType::RECTANGLE, 50, 50, 600, 300);
main_shape.text_frame()->set_text("Main slide content");
// Create the notes slide and write text
auto* notes = slide.notes_slide_manager().add_notes_slide();
notes->notes_text_frame().set_text(
"Mention the Q3 revenue increase. Emphasize the 24% YoY growth.");
prs.save("with-notes.pptx", asf::SaveFormat::PPTX);
return 0;
}إضافة ملاحظات إلى عدة شرائح
#include <Aspose/Slides/Foss/presentation.h>
#include <vector>
#include <string>
int main() {
namespace asf = Aspose::Slides::Foss;
std::vector<std::string> note_texts = {
"Opening: introduce the agenda and set expectations.",
"Key metrics: emphasize Q4 results and growth trajectory.",
"Closing: summarize and call to action.",
};
asf::Presentation prs;
auto& layout = prs.slides()[0].layout_slide();
prs.slides().add_empty_slide(layout);
prs.slides().add_empty_slide(layout);
for (size_t i = 0; i < prs.slides().size(); ++i) {
auto& slide = prs.slides()[i];
auto& slide_shape = slide.shapes().add_auto_shape(
asf::ShapeType::RECTANGLE, 50, 50, 600, 300);
slide_shape.text_frame()->set_text("Slide " + std::to_string(i + 1));
auto* n = slide.notes_slide_manager().add_notes_slide();
n->notes_text_frame().set_text(note_texts[i]);
}
prs.save("all-notes.pptx", asf::SaveFormat::PPTX);
return 0;
}تحقق مما إذا كانت الملاحظات موجودة بالفعل
notes_slide_manager().notes_slide() تُعيد مؤشرًا فارغًا إذا لم يتم إنشاء شريحة ملاحظات:
#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>
int main() {
namespace asf = Aspose::Slides::Foss;
asf::Presentation prs("existing.pptx");
for (size_t i = 0; i < prs.slides().size(); ++i) {
auto& slide = prs.slides()[i];
auto* existing = slide.notes_slide_manager().notes_slide();
if (existing) {
std::cout << "Slide " << i + 1 << ": "
<< existing->notes_text_frame().text().substr(0, 60) << "\n";
} else {
std::cout << "Slide " << i + 1 << ": no notes\n";
}
}
return 0;
}