在 C++ 中管理簡報表格

本頁內容簡介

使用 Aspose.Slides for C++ 在 PowerPoint 投影片中建立與編輯表格。探索簡單的程式碼範例，以簡化您的表格工作流程。

簡介

PowerPoint 中的表格是顯示和呈現資訊的有效方式。以行列排列的格子網格中的資訊直觀且易於理解。

Aspose.Slides 提供了 Table 類別、ITable 介面、Cell 類別、ICell 介面，以及其他類型，讓您能在各種簡報中建立、更新和管理表格。

從頭建立表格

1. 建立 Presentation 類別的實例。
2. 透過索引取得投影片的參考。
3. 定義 columnWidth 陣列。
4. 定義 rowHeight 陣列。
5. 透過 AddTable() 方法將 ITable 物件新增至投影片。
6. 遍歷每個 ICell ，套用上、下、右、左邊框的格式設定。
7. 合併表格第一列的前兩個儲存格。
8. 存取 ICell’s TextFrame。
9. 將文字新增到 TextFrame。
10. 儲存已修改的簡報。

以下 C++ 程式碼示範如何在簡報中建立表格：

#include <DOM/FillType.h>
#include <DOM/IColorFormat.h>
#include <DOM/ILineFillFormat.h>
#include <DOM/ILineFormat.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ITextFrame.h>
#include <DOM/Presentation.h>
#include <DOM/Table/ICell.h>
#include <DOM/Table/ICellFormat.h>
#include <DOM/Table/IRow.h>
#include <DOM/Table/IRowCollection.h>
#include <DOM/Table/ITable.h>
#include <Export/SaveFormat.h>
#include <drawing/color.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System::Drawing;

// 建立代表 PPTX 檔案的 Presentation 類別實例
auto pres = System::MakeObject<Presentation>();

// 取得第一張投影片
auto sld = pres->get_Slides()->idx_get(0);

// 定義欄寬與列高
auto dblCols = System::MakeArray<double>({ 50, 50, 50 });
auto dblRows = System::MakeArray<double>({ 50, 30, 30, 30, 30 });

// 在投影片中新增表格圖形
auto tbl = sld->get_Shapes()->AddTable(100.0f, 50.0f, dblCols, dblRows);

// 設定每個儲存格的邊框格式
for (int32_t row = 0; row < tbl->get_Rows()->get_Count(); row++)
{
    for (int32_t cell = 0; cell < tbl->get_Rows()->idx_get(row)->get_Count(); cell++)
    {
        auto cellFormat = tbl->get_Rows()->idx_get(row)->idx_get(cell)->get_CellFormat();

        cellFormat->get_BorderTop()->get_FillFormat()->set_FillType(FillType::Solid);
        cellFormat->get_BorderTop()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());
        cellFormat->get_BorderTop()->set_Width(5);

        cellFormat->get_BorderBottom()->get_FillFormat()->set_FillType((FillType::Solid));
        cellFormat->get_BorderBottom()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());
        cellFormat->get_BorderBottom()->set_Width(5);

        cellFormat->get_BorderLeft()->get_FillFormat()->set_FillType(FillType::Solid);
        cellFormat->get_BorderLeft()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());
        cellFormat->get_BorderLeft()->set_Width(5);

        cellFormat->get_BorderRight()->get_FillFormat()->set_FillType(FillType::Solid);
        cellFormat->get_BorderRight()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());
        cellFormat->get_BorderRight()->set_Width(5);
    }
}
// 合併第 1 列的第 1 與第 2 個儲存格
tbl->MergeCells(tbl->get_Rows()->idx_get(0)->idx_get(0), tbl->get_Rows()->idx_get(1)->idx_get(1), false);

// 在合併後的儲存格中加入文字
tbl->get_Rows()->idx_get(0)->idx_get(0)->get_TextFrame()->set_Text(u"Merged Cells");

// 將簡報儲存至磁碟
pres->Save(u"table.pptx", SaveFormat::Pptx);

標準表格的編號

在標準表格中，儲存格的編號方式簡單且從 0 起算。表格的第一個儲存格編號為 0,0（第 0 列，第 0 行）。

例如，具有 4 列 4 行的表格，其儲存格編號如下：

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

以下 C++ 程式碼示範如何為表格中的儲存格指定編號：

#include <DOM/FillType.h>
#include <DOM/IColorFormat.h>
#include <DOM/IFillFormat.h>
#include <DOM/ILineFillFormat.h>
#include <DOM/ILineFormat.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/Presentation.h>
#include <DOM/Table/ICell.h>
#include <DOM/Table/ICellFormat.h>
#include <DOM/Table/IRow.h>
#include <DOM/Table/IRowCollection.h>
#include <DOM/Table/ITable.h>
#include <Export/SaveFormat.h>
#include <drawing/color.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System::Drawing;

// 建立代表 PPTX 檔案的 Presentation 類別實例
auto pres = System::MakeObject<Presentation>();

// 取得第一張投影片
auto sld = pres->get_Slides()->idx_get(0);

// 定義欄寬與列高
auto dblCols = System::MakeArray<double>({ 70, 70, 70, 70 });
auto dblRows = System::MakeArray<double>({ 70, 70, 70, 70 });

// 在投影片中新增表格圖形
auto tbl = sld->get_Shapes()->AddTable(100.0f, 50.0f, dblCols, dblRows);

// 設定每個儲存格的邊框格式
for (const auto& row : tbl->get_Rows())
{
    for (const auto& cell : row)
    {
        auto cellFormat = cell->get_CellFormat();
        cellFormat->get_BorderTop()->get_FillFormat()->set_FillType(FillType::Solid);
        cellFormat->get_BorderTop()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());
        cellFormat->get_BorderTop()->set_Width(5);

        cellFormat->get_BorderBottom()->get_FillFormat()->set_FillType(FillType::Solid);
        cellFormat->get_BorderBottom()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());
        cellFormat->get_BorderBottom()->set_Width(5);

        cellFormat->get_BorderLeft()->get_FillFormat()->set_FillType(FillType::Solid);
        cellFormat->get_BorderLeft()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());
        cellFormat->get_BorderLeft()->set_Width(5);

        cellFormat->get_BorderRight()->get_FillFormat()->set_FillType(FillType::Solid);
        cellFormat->get_BorderRight()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());
        cellFormat->get_BorderRight()->set_Width(5);
    }
}

// 將簡報儲存至磁碟
pres->Save(u"StandardTables_out.pptx", SaveFormat::Pptx);

存取現有表格

1. 建立 Presentation 類別的實例。

2. 透過索引取得包含表格之投影片的參考。

3. 建立 ITable 物件，並將其設為 null。

4. 遍歷所有 IShape 物件，直到找到表格。

   如果您懷疑該投影片只包含單一表格，您可以直接檢查其所有形狀。當形狀被辨識為表格時，您可以將其類型轉換為 Table 物件。但如果該投影片包含多個表格，則最好透過其 set_AlternativeText() 來搜尋所需的表格。

5. 使用 ITable 物件來操作表格。在以下範例中，我們在表格中新增了一列。

6. 儲存已修改的簡報。

以下 C++ 程式碼示範如何存取並操作現有表格：

#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ITextFrame.h>
#include <DOM/Presentation.h>
#include <DOM/Table/ICell.h>
#include <DOM/Table/ITable.h>
#include <Export/SaveFormat.h>
#include <system/enumerator_adapter.h>
#include <system/object_ext.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

// 建立代表 PPTX 檔案的 Presentation 類別實例
auto pres = System::MakeObject<Presentation>(u"UpdateExistingTable.pptx");

// 取得第一張投影片
auto sld = pres->get_Slides()->idx_get(0);

// 初始化 null 表格
System::SharedPtr<ITable> tbl;

// 迭代形狀並設定找到的表格參考
for (const auto& shp : System::IterateOver(sld->get_Shapes()))
{
    if (System::ObjectExt::Is<ITable>(shp))
    {
        tbl = System::ExplicitCast<ITable>(shp);
    }
}

// 為第二列的第一欄設定文字
tbl->idx_get(0, 1)->get_TextFrame()->set_Text(u"New");

// 將修改後的簡報儲存至磁碟
pres->Save(u"table1_out.pptx", SaveFormat::Pptx);

尋找擁有文字框的儲存格

當通用文字處理程式碼從表格取得 ITextFrame 時，請使用 ITextFrame::get_ParentCell 取得擁有該文字框的 ICell。對於表格儲存格的文字框，ITextFrame::get_ParentCell 會傳回其擁有者，而 ITextFrame::get_ParentShape 會傳回 nullptr，即使表格本身也是形狀。

儲存格座標可透過唯讀的 ICell::get_FirstColumnIndex 與 ICell::get_FirstRowIndex 方法取得。 ITextFrame::get_ParentCell 亦提供唯讀的導覽：它傳回擁有者但不會變更所有權。使用前務必檢查傳回的儲存格是否為 nullptr。

完整範例（識別表格儲存格與形狀的擁有者，包含與 SmartArt 節點相關的形狀）請參閱 Search and Replace Text。

對齊表格中的文字

1. 建立 Presentation 類別的實例。
2. 透過索引取得投影片的參考。
3. 將 ITable 物件新增至投影片。
4. 從表格取得 ITextFrame 物件。
5. 存取該 ITextFrame 的 IParagraph。
6. 垂直對齊文字。
7. 儲存已修改的簡報。

以下 C++ 程式碼示範如何在表格中對齊文字：

#include <DOM/FillType.h>
#include <DOM/IColorFormat.h>
#include <DOM/IFillFormat.h>
#include <DOM/IParagraph.h>
#include <DOM/IParagraphCollection.h>
#include <DOM/IPortion.h>
#include <DOM/IPortionCollection.h>
#include <DOM/IPortionFormat.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ITextFrame.h>
#include <DOM/Presentation.h>
#include <DOM/Table/ICell.h>
#include <DOM/Table/ITable.h>
#include <DOM/TextAnchorType.h>
#include <DOM/TextVerticalType.h>
#include <Export/SaveFormat.h>
#include <drawing/color.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System::Drawing;

// 建立 Presentation 類別的實例
auto presentation = System::MakeObject<Presentation>();

// 取得第一張投影片
auto slide = presentation->get_Slides()->idx_get(0);

// 定義欄寬與列高
auto dblCols = System::MakeArray<double>({ 120, 120, 120, 120 });
auto dblRows = System::MakeArray<double>({ 100, 100, 100, 100 });

// 在投影片中新增表格圖形
auto tbl = slide->get_Shapes()->AddTable(100.0f, 50.0f, dblCols, dblRows);
tbl->idx_get(1, 0)->get_TextFrame()->set_Text(u"10");
tbl->idx_get(2, 0)->get_TextFrame()->set_Text(u"20");
tbl->idx_get(3, 0)->get_TextFrame()->set_Text(u"30");

// 存取文字框
auto txtFrame = tbl->idx_get(0, 0)->get_TextFrame();

// 為文字框建立 Paragraph 物件
auto paragraph = txtFrame->get_Paragraphs()->idx_get(0);

// 為段落建立 Portion 物件
auto portion = paragraph->get_Portions()->idx_get(0);
portion->set_Text(u"Text here");
portion->get_PortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
portion->get_PortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black());

// 垂直對齊文字
auto cell = tbl->idx_get(0, 0);
cell->set_TextAnchorType(TextAnchorType::Center);
cell->set_TextVerticalType(TextVerticalType::Vertical270);

// 將簡報儲存至磁碟
presentation->Save(u"Vertical_Align_Text_out.pptx", SaveFormat::Pptx);

在表格層級設定文字格式

1. 建立 the Presentation 類別的實例。
2. 透過索引取得投影片的參考。
3. 從投影片存取 ITable 物件。
4. 設定文字的 set_FontHeight()。
5. 設定 set_Alignment() 與 set_MarginRight()。
6. 設定 set_TextVerticalType()。
7. 儲存已修改的簡報。

以下 C++ 程式碼示範如何將您偏好的格式套用於表格中的文字：

#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ParagraphFormat.h>
#include <DOM/PortionFormat.h>
#include <DOM/Presentation.h>
#include <DOM/Table/ITable.h>
#include <DOM/TextAlignment.h>
#include <DOM/TextFrameFormat.h>
#include <DOM/TextVerticalType.h>
#include <Export/SaveFormat.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

// 建立 Presentation 類別的實例
auto presentation = System::MakeObject<Presentation>();
auto slide = presentation->get_Slides()->idx_get(0);

// 假設第一張投影片上的第一個形狀是表格
auto someTable = System::AsCast<ITable>(presentation->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0));

// 設定表格儲存格的字型高度
auto portionFormat = System::MakeObject<PortionFormat>();
portionFormat->set_FontHeight(25.0f);
someTable->SetTextFormat(portionFormat);

// 一次呼叫設定表格儲存格的文字對齊方式與右邊距
auto paragraphFormat = System::MakeObject<ParagraphFormat>();
paragraphFormat->set_Alignment(TextAlignment::Right);
paragraphFormat->set_MarginRight(20.0f);
someTable->SetTextFormat(paragraphFormat);

// 設定表格儲存格的文字垂直類型
auto textFrameFormat = System::MakeObject<TextFrameFormat>();
textFrameFormat->set_TextVerticalType(TextVerticalType::Vertical);
someTable->SetTextFormat(textFrameFormat);

presentation->Save(u"result.pptx", SaveFormat::Pptx);

取得表格樣式屬性

Aspose.Slides 允許您取得表格的樣式屬性，以便將這些細節用於其他表格或其他位置。以下 C++ 程式碼示範如何從表格預設樣式取得樣式屬性：

#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <DOM/Table/ITable.h>
#include <DOM/TableStylePreset.h>
#include <Export/SaveFormat.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slide(0)->get_Shapes();
auto table = System::ExplicitCast<ITable>(shapes->AddTable(10, 10, System::MakeArray<double>({100, 150}), System::MakeArray<double>({5, 5, 5})));

table->set_StylePreset(TableStylePreset::DarkStyle1);
pres->Save(u"table.pptx", SaveFormat::Pptx);

鎖定表格的長寬比

幾何形狀的長寬比是其在不同維度上的尺寸比例。Aspose.Slides 提供了 AspectRatioLocked() 屬性，可讓您鎖定表格及其他形狀的長寬比設定。

以下 C++ 程式碼示範如何鎖定表格的長寬比：

#include <DOM/IGraphicalObjectLock.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/Presentation.h>
#include <DOM/Table/ITable.h>
#include <Export/SaveFormat.h>
#include <system/console.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto pres = System::MakeObject<Presentation>(u"pres.pptx");
auto table = System::ExplicitCast<ITable>(pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0));

Console::WriteLine(u"Lock aspect ratio set: {0}", table->get_GraphicalObjectLock()->get_AspectRatioLocked());


table->get_GraphicalObjectLock()->set_AspectRatioLocked(!table->get_GraphicalObjectLock()->get_AspectRatioLocked());

Console::WriteLine(u"Lock aspect ratio set: {0}", table->get_GraphicalObjectLock()->get_AspectRatioLocked());

pres->Save(u"pres-out.pptx", SaveFormat::Pptx);

常見問題

我可以為整個表格及其儲存格內的文字啟用從右至左 (RTL) 讀取方向嗎？

是的。表格提供了 set_RightToLeft 方法，段落則有 ParagraphFormat::set_RightToLeft。兩者皆使用可確保儲存格內的正確 RTL 排序與呈現。

我該如何防止使用者在最終檔案中移動或調整表格的大小？

使用 shape locks 可停用移動、調整大小、選取等功能。此鎖定亦適用於表格。

是否支援在儲存格內插入圖片作為背景？

是的。您可以為儲存格設定 picture fill，圖片會依選擇的模式（拉伸或平鋪）覆蓋儲存格區域。