Wie man mit Tabellen in C++ arbeitet

Aspose.Slides FOSS for C++ unterstützt das Erstellen von Tabellen auf Folien mit konfigurierbaren Spaltenbreiten und Zeilenhöhen. Dieser Leitfaden zeigt, wie man eine Tabelle hinzufügt, sie mit Daten füllt und grundlegende Textformatierung auf Zellen anwendet.

Schritt-für-Schritt-Anleitung

Schritt 1: Bibliothek erstellen und verlinken

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 .

Schritt 2: Präsentation erstellen oder öffnen

#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;
}

Schritt 3: Spaltenbreiten und Zeilenhöhen definieren

Tabellen erfordern explizite Spaltenbreiten und Zeilenhöhen in Punkten (1 Punkt = 1/72 Zoll). Eine Standardfolie ist 720 Punkte breit und 540 Punkte hoch.

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

Schritt 4: Tabelle hinzufügen

slide.shapes().add_table(x, y, col_widths, row_heights) erstellt die Tabelle an Position (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;
}

Schritt 5: Zelleninhalt festlegen

Greifen Sie über table.rows()[row_index][col_index] auf Zellen zu und weisen Sie Text über .text_frame()->set_text() zu:

#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;
}

Schritt 6: Header‑Zellen‑Text formatieren

Wenden Sie die fette Formatierung auf Kopfzeilenzellen mit PortionFormat an:

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));
    }
}

Vollständiges funktionierendes Beispiel

#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;
}

Häufige Probleme und Lösungen

std::out_of_range beim Zugriff auf table.rows()[row][col]

Zeilen- und Spaltenindizes sind nullbasiert. Wenn Sie row_heights mit 3 Elementen definiert haben, sind gültige Zeilenindizes 0, 1, 2.

Zelltext erscheint nicht in der gespeicherten Datei

Weisen Sie immer über .text_frame()->set_text() zu, nicht direkt über .set_text() am Zellenobjekt.

Tabellenposition liegt außerhalb der Folie

Überprüfen Sie, dass x + sum(col_widths) <= 720 und y + sum(row_heights) <= 540 für eine Standardfolie.

Häufig gestellte Fragen

Kann ich Tabellenzellen zusammenführen?

Das Zusammenführen von Zellen wird in dieser Edition nicht unterstützt.

Kann ich eine tabellenweite Hintergrundfarbe anwenden?

Füllenformatierung auf jede einzelne Zelle anwenden:

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));
    }
}

Kann ich Zellrandstile festlegen?

Zellrand‑Eigenschaften sind über die Zellformat‑Randmethoden zugänglich. Siehe die API‑Referenz für die vollständige Liste der Randformatattribute.