วิธีทำงานกับตารางใน C++

Aspose.Slides FOSS for C++ supports creating tables on slides with configurable column widths and row heights. This guide shows how to add a table, populate it with data, and apply basic text formatting to cells.

คู่มือแบบขั้นตอนต่อขั้นตอน

ขั้นตอนที่ 1: สร้างและลิงก์ไลบรารี

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 .

ขั้นตอนที่ 2: สร้างหรือเปิดงานนำเสนอ

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

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

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

ขั้นตอนที่ 3: กำหนดความกว้างของคอลัมน์และความสูงของแถว

ตารางต้องการความกว้างของคอลัมน์และความสูงของแถวที่ระบุเป็นจุด (1 point = 1/72 นิ้ว) สไลด์มาตรฐานมีความกว้าง 720 จุดและความสูง 540 จุด.

std::vector<double> col_widths = {200.0, 150.0, 150.0};  // 3 columns
std::vector<double> row_heights = {45.0, 40.0, 40.0};    // 3 rows

ขั้นตอนที่ 4: เพิ่มตาราง

slide.shapes().add_table(x, y, col_widths, row_heights) สร้างตารางที่ตำแหน่ง (x, y):

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

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

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

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

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

ขั้นตอนที่ 5: ตั้งค่าข้อความในเซลล์

เข้าถึงเซลล์ผ่าน table.rows()[row_index][col_index] และกำหนดข้อความผ่าน .text_frame()->set_text():

#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 = {200.0, 150.0, 150.0};
    std::vector<double> row_heights = {45.0, 40.0, 40.0};
    auto& table = slide.shapes().add_table(50, 100, col_widths, row_heights);

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

    // Data rows
    std::vector<std::vector<std::string>> data = {
        {"Widget A", "1,200", "$24,000"},
        {"Widget B", "850",   "$17,000"},
    };
    for (size_t r = 0; r < data.size(); ++r) {
        for (size_t c = 0; c < data[r].size(); ++c) {
            table.rows()[r + 1][c].text_frame()->set_text(data[r][c]);
        }
    }

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

ขั้นตอนที่ 6: จัดรูปแบบข้อความหัวตาราง

ใช้การจัดรูปแบบตัวหนากับเซลล์หัวตารางโดยใช้ PortionFormat:

for (size_t col = 0; col < headers.size(); ++col) {
    auto& cell = table.rows()[0][col];
    auto& portions = cell.text_frame()->paragraphs()[0].portions();
    if (portions.size() > 0) {
        auto& fmt = portions[0].portion_format();
        fmt.set_font_bold(asf::NullableBool::TRUE);
        fmt.fill_format().set_fill_type(asf::FillType::SOLID);
        fmt.fill_format().solid_fill_color().set_color(
            asf::Color::from_argb(255, 255, 255, 255));
    }
}

ตัวอย่างทำงานครบถ้วน

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

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

    std::vector<std::vector<std::string>> data_rows = {
        {"North", "$1.2M", "+8%"},
        {"South", "$0.9M", "+4%"},
        {"East",  "$1.5M", "+12%"},
        {"West",  "$0.7M", "+2%"},
    };
    std::vector<std::string> headers = {"Region", "Revenue", "Growth"};

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

    std::vector<double> col_widths = {180.0, 140.0, 120.0};
    std::vector<double> row_heights(1 + data_rows.size(), 38.0);
    row_heights[0] = 45.0;

    auto& table = slide.shapes().add_table(60, 80, col_widths, row_heights);

    // Header row
    for (size_t col = 0; col < headers.size(); ++col) {
        auto& cell = table.rows()[0][col];
        cell.text_frame()->set_text(headers[col]);
        auto& portions = cell.text_frame()->paragraphs()[0].portions();
        if (portions.size() > 0) {
            portions[0].portion_format().set_font_bold(asf::NullableBool::TRUE);
        }
    }

    // Data rows
    for (size_t r = 0; r < data_rows.size(); ++r) {
        for (size_t c = 0; c < data_rows[r].size(); ++c) {
            table.rows()[r + 1][c].text_frame()->set_text(data_rows[r][c]);
        }
    }

    prs.save("regional-revenue.pptx", asf::SaveFormat::PPTX);
    std::cout << "Saved regional-revenue.pptx\n";
    return 0;
}

ปัญหาทั่วไปและวิธีแก้

std::out_of_range เมื่อเข้าถึง table.rows()[row][col]

ดัชนีแถวและคอลัมน์เริ่มจากศูนย์ หากคุณกำหนด row_heights โดยมี 3 องค์ประกอบ ดัชนีแถวที่ถูกต้องคือ 0, 1, 2.

Cell text does not appear in the saved file

กำหนดค่าตลอดผ่าน .text_frame()->set_text(), ไม่ใช่ผ่าน .set_text() โดยตรงบนอ็อบเจ็กต์เซลล์.

ตำแหน่งของตารางอยู่นอกสไลด์

ตรวจสอบว่า x + sum(col_widths) <= 720 และ y + sum(row_heights) <= 540 สำหรับสไลด์มาตรฐาน.

คำถามที่พบบ่อย

ฉันสามารถรวมเซลล์ของตารางได้หรือไม่?

การรวมเซลล์ไม่ได้รับการสนับสนุนในรุ่นนี้.

ฉันสามารถกำหนดสีพื้นหลังให้กับตารางทั้งหมดได้หรือไม่?

ใช้การจัดรูปแบบการเติมสีกับแต่ละเซลล์แยกกัน:

for (size_t r = 0; r < table.rows().size(); ++r) {
    for (size_t c = 0; c < table.rows()[r].size(); ++c) {
        auto& cell = table.rows()[r][c];
        cell.fill_format().set_fill_type(asf::FillType::SOLID);
        cell.fill_format().solid_fill_color().set_color(
            asf::Color::from_argb(255, 240, 248, 255));
    }
}

ฉันสามารถตั้งค่ารูปแบบเส้นขอบของเซลล์ได้หรือไม่?

คุณสมบัติของเส้นขอบเซลล์สามารถเข้าถึงได้ผ่านเมธอดเส้นขอบของรูปแบบเซลล์. โปรดดูอ้างอิง API สำหรับรายการเต็มของแอตทริบิวต์รูปแบบเส้นขอบ.