چگونه اشکال را به پاورپوینت در C++ اضافه کنیم

چگونه اشکال را به پاورپوینت در C++ اضافه کنیم

Aspose.Slides FOSS for C++ از افزودن AutoShapes، Tables، Connectors و PictureFrames به اسلایدهای ارائه پشتیبانی می‌کند. تمام انواع شکل‌ها از طریق مجموعه slide.shapes() اضافه می‌شوند.

راهنمای گام به گام

مرحله ۱: ساخت و لینک کتابخانه

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 .

مرحله ۲: ایجاد یک ارائه

از تخصیص پشته برای پاک‌سازی RAII استفاده کنید.

#include <Aspose/Slides/Foss/presentation.h>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;
    auto& slide = prs.slides()[0];
    // ... add shapes ...
    prs.save("output.pptx", asf::SaveFormat::PPTX);
    return 0;
}

مرحله ۳: افزودن یک AutoShape

slide.shapes().add_auto_shape(shape_type, x, y, width, height) یک شکل را در موقعیت و اندازهٔ داده‌شده (همه به نقطه) قرار می‌دهد. برای انتخاب شکل از ثابت‌های ShapeType استفاده کنید.

#include <Aspose/Slides/Foss/presentation.h>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;
    auto& slide = prs.slides()[0];

    // Rectangle
    auto& rect = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 50, 50, 300, 100);
    rect.text_frame()->set_text("Rectangle shape");

    // Ellipse
    auto& ellipse = slide.shapes().add_auto_shape(
        asf::ShapeType::ELLIPSE, 400, 50, 200, 100);
    ellipse.text_frame()->set_text("Ellipse shape");

    prs.save("autoshapes.pptx", asf::SaveFormat::PPTX);
    return 0;
}

مرحله ۴: افزودن جدول

slide.shapes().add_table(x, y, col_widths, row_heights) یک جدول در موقعیت مشخص ایجاد می‌کند. عرض ستون‌ها و ارتفاع ردیف‌ها بردارهایی از مقادیر نقطه‌ای هستند.

#include <Aspose/Slides/Foss/presentation.h>
#include <vector>
#include <string>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;
    auto& slide = prs.slides()[0];

    std::vector<double> col_widths = {150.0, 150.0, 150.0};
    std::vector<double> row_heights = {40.0, 40.0, 40.0};
    auto& table = slide.shapes().add_table(50, 200, col_widths, row_heights);

    // Set header row text
    std::vector<std::string> headers = {"Product", "Units", "Revenue"};
    for (size_t col = 0; col < headers.size(); ++col) {
        table.rows()[0][col].text_frame()->set_text(headers[col]);
    }

    // Set data rows
    std::vector<std::vector<std::string>> rows = {
        {"Widget A", "120", "$2,400"},
        {"Widget B", "85",  "$1,700"},
    };
    for (size_t r = 0; r < rows.size(); ++r) {
        for (size_t c = 0; c < rows[r].size(); ++c) {
            table.rows()[r + 1][c].text_frame()->set_text(rows[r][c]);
        }
    }

    prs.save("table.pptx", asf::SaveFormat::PPTX);
    return 0;
}

مرحله 5: افزودن یک اتصالگر

اتصالات دو شکل را به صورت بصری به هم متصل می‌کنند. ابتدا شکل‌ها را ایجاد کنید، سپس یک اتصال اضافه کنید و نقاط اتصال شروع و پایان آن را تنظیم کنید.

#include <Aspose/Slides/Foss/presentation.h>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;
    auto& slide = prs.slides()[0];

    auto& box1 = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 50, 100, 150, 60);
    box1.text_frame()->set_text("Start");

    auto& box2 = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 350, 100, 150, 60);
    box2.text_frame()->set_text("End");

    auto& conn = slide.shapes().add_connector(
        asf::ShapeType::BENT_CONNECTOR3, 0, 0, 10, 10);
    conn.set_start_shape_connected_to(&box1);
    conn.set_start_shape_connection_site_index(3); // right side of box1
    conn.set_end_shape_connected_to(&box2);
    conn.set_end_shape_connection_site_index(1);   // left side of box2

    prs.save("connector.pptx", asf::SaveFormat::PPTX);
    return 0;
}

شاخص‌های نقاط اتصال برای یک مستطیل از 0 تا 3 شماره‌گذاری می‌شوند: top=0، left=1، bottom=2، right=3.


مرحله ۶: افزودن یک قاب تصویر

یک تصویر را جاسازی کنید و به عنوان PictureFrame به اسلاید اضافه کنید. ابتدا بایت‌های تصویر را بخوانید، آن‌ها را به مجموعه تصاویر ارائه اضافه کنید، سپس فریم را ایجاد کنید.

#include <Aspose/Slides/Foss/presentation.h>
#include <fstream>
#include <vector>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;

    std::ifstream file("logo.png", std::ios::binary);
    std::vector<uint8_t> data((std::istreambuf_iterator<char>(file)),
                               std::istreambuf_iterator<char>());

    auto& image = prs.images().add_image(data);

    auto& slide = prs.slides()[0];
    slide.shapes().add_picture_frame(
        asf::ShapeType::RECTANGLE, // bounding shape type
        50, 50,                    // x, y in points
        200, 150,                  // width, height in points
        image);

    prs.save("with-image.pptx", asf::SaveFormat::PPTX);
    return 0;
}

مشکلات رایج و راه‌حل‌ها

شکل خارج از ناحیه قابل مشاهده اسلاید ظاهر می‌شود

اسلایدها به‌صورت پیش‌فرض 720 × 540 نقطه هستند. مقادیر x یا y که خارج از این حدود باشند، شکل را خارج از اسلاید قرار می‌دهند. x < 720 و y < 540 را نگه دارید و اطمینان حاصل کنید x + width <= 720 و y + height <= 540.

add_auto_shape() یک مرجع به شیء نابود شده برمی‌گرداند

ارجاع‌ها را فراتر از طول عمر Presentation ذخیره نکنید. تمام اشیای فرزند توسط Presentation مالکیت می‌شوند و در زمان تخریب نامعتبر می‌گردند.

متن سلول جدول پس از اختصاص خالی است

روش صحیح .text_frame()->set_text() است. دسترسی به سلول‌ها به صورت table.rows()[row_index][col_index].text_frame()->set_text("value").


سوالات متداول

چند شکل می‌توانم به یک اسلاید اضافه کنم؟

هیچ محدودیتی توسط کتابخانه اعمال نمی‌شود. محدودیت‌های عملی به اندازهٔ فایل و قابلیت رندرینگ نمایشگر PPTX هدف شما بستگی دارد.

آیا می‌توانم موقعیت یک شکل را پس از افزودن آن تغییر دهم؟

بله. شیء شکل که توسط add_auto_shape() برگردانده می‌شود، متدهای set_x()، set_y()، set_width() و set_height() را دارد:

shape.set_x(100);
shape.set_y(200);
shape.set_width(400);
shape.set_height(80);

آیا می‌توانم رنگ خط‌مرز (حاشیه) شکل را تنظیم کنم؟

بله، از طریق shape.line_format():

shape.line_format().fill_format().solid_fill_color().set_color(
    asf::Color::from_argb(255, 200, 0, 0));

آیا نمودارها پشتیبانی می‌شوند؟

خیر. نمودارها، SmartArt و اشیاء OLE در این نسخه پیاده‌سازی نشده‌اند.


همچنین ببینید

 فارسی