Cara Bekerja dengan Tabel di .NET

Aspose.Slides FOSS for .NET mendukung pembuatan tabel pada slide dengan lebar kolom dan tinggi baris yang dapat dikonfigurasi. Panduan ini menunjukkan cara menambahkan tabel, mengisinya dengan data, dan menerapkan pemformatan teks dasar pada sel.

Panduan Langkah-demi-Langkah

Langkah 1: Instal Paket

dotnet add package Aspose.Slides.Foss

Langkah 2: Buat atau Buka Presentasi

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
// ... add table ...
prs.Save("table.pptx", SaveFormat.Pptx);

Langkah 3: Tentukan Lebar Kolom dan Tinggi Baris

Tabel memerlukan lebar kolom dan tinggi baris yang eksplisit dalam poin (1 poin = 1/72 inci). Sebuah slide standar memiliki lebar 720 poin dan tinggi 540 poin.

var colWidths = new double[] { 200.0, 150.0, 150.0 };   // 3 columns
var rowHeights = new double[] { 45.0, 40.0, 40.0 };     // 3 rows

Langkah 4: Tambahkan Tabel

slide.Shapes.AddTable(x, y, columnWidths, rowHeights) membuat tabel pada posisi (x, y):

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];

var colWidths = new double[] { 200.0, 150.0, 150.0 };
var rowHeights = new double[] { 45.0, 40.0, 40.0 };
var table = slide.Shapes.AddTable(50, 100, colWidths, rowHeights);

prs.Save("table.pptx", SaveFormat.Pptx);

Langkah 5: Atur Teks Sel

Akses sel melalui table.Rows[rowIndex][colIndex] dan tetapkan teks melalui .TextFrame.Text:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];

var colWidths = new double[] { 200.0, 150.0, 150.0 };
var rowHeights = new double[] { 45.0, 40.0, 40.0 };
var table = slide.Shapes.AddTable(50, 100, colWidths, rowHeights);

// Header row (row 0)
string[] headers = { "Product", "Units Sold", "Revenue" };
for (int col = 0; col < headers.Length; col++)
    table.Rows[0][col].TextFrame.Text = headers[col];

// Data rows
string[][] data = {
    new[] { "Widget A", "1,200", "$24,000" },
    new[] { "Widget B", "850", "$17,000" },
};
for (int rowIdx = 0; rowIdx < data.Length; rowIdx++)
    for (int col = 0; col < data[rowIdx].Length; col++)
        table.Rows[rowIdx + 1][col].TextFrame.Text = data[rowIdx][col];

prs.Save("sales-table.pptx", SaveFormat.Pptx);

Langkah 6: Format Teks Sel Header

Terapkan format tebal pada sel header menggunakan PortionFormat:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;

for (int col = 0; col < headers.Length; col++)
{
    var cell = table.Rows[0][col];
    var portions = cell.TextFrame.Paragraphs[0].Portions;
    if (portions.Count > 0)
    {
        var fmt = portions[0].PortionFormat;
        fmt.FontBold = NullableBool.True;
        fmt.FillFormat.FillType = FillType.Solid;
        fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 255, 255, 255);
    }
}

Contoh Kerja Lengkap

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

string[][] dataRows = {
    new[] { "North", "$1.2M", "+8%" },
    new[] { "South", "$0.9M", "+4%" },
    new[] { "East",  "$1.5M", "+12%" },
    new[] { "West",  "$0.7M", "+2%" },
};
string[] headers = { "Region", "Revenue", "Growth" };

using var prs = new Presentation();
var slide = prs.Slides[0];

var colWidths = new double[] { 180.0, 140.0, 120.0 };
var rowHeights = new double[dataRows.Length + 1];
rowHeights[0] = 45.0;
for (int i = 1; i < rowHeights.Length; i++) rowHeights[i] = 38.0;

var table = slide.Shapes.AddTable(60, 80, colWidths, rowHeights);

// Header row
for (int col = 0; col < headers.Length; col++)
{
    var cell = table.Rows[0][col];
    cell.TextFrame.Text = headers[col];
    if (cell.TextFrame.Paragraphs[0].Portions.Count > 0)
    {
        var fmt = cell.TextFrame.Paragraphs[0].Portions[0].PortionFormat;
        fmt.FontBold = NullableBool.True;
    }
}

// Data rows
for (int rowIdx = 0; rowIdx < dataRows.Length; rowIdx++)
    for (int col = 0; col < dataRows[rowIdx].Length; col++)
        table.Rows[rowIdx + 1][col].TextFrame.Text = dataRows[rowIdx][col];

prs.Save("regional-revenue.pptx", SaveFormat.Pptx);
Console.WriteLine("Saved regional-revenue.pptx");

Masalah Umum dan Solusi

IndexOutOfRangeException saat mengakses table.Rows[row][col]

Indeks baris dan kolom berbasis nol. Jika Anda mendefinisikan rowHeights dengan 3 elemen, indeks baris yang valid adalah 0, 1, 2.

Teks sel tidak muncul di file yang disimpan

Selalu tetapkan melalui .TextFrame.Text, bukan melalui .Text secara langsung pada objek sel:

// Correct
table.Rows[0][0].TextFrame.Text = "Header";

// Wrong: will not compile or silent failure
// table.Rows[0][0].Text = "Header";

Posisi tabel berada di luar slide

Periksa bahwa x + sum(colWidths) <= 720 dan y + sum(rowHeights) <= 540 untuk slide standar.

Pertanyaan yang Sering Diajukan

Bisakah saya menggabungkan sel tabel?

Ya. Gunakan Table.MergeCells(ICell cell1, ICell cell2, bool allowSplitting) untuk menggabungkan dua sel yang berdekatan. Setel allowSplitting ke false untuk mencegah sel yang digabungkan terpecah lagi. Contoh:

// Merge cell (row 0, col 0) with cell (row 0, col 1)
var cell1 = table.Rows[0][0];
var cell2 = table.Rows[0][1];
table.MergeCells(cell1, cell2, false);

Bisakah saya menerapkan warna latar belakang untuk seluruh tabel?

Terapkan pemformatan isi pada setiap sel secara individual:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;

for (int row = 0; row < table.Rows.Count; row++)
    for (int col = 0; col < table.Rows[row].Count; col++)
    {
        var cell = table.Rows[row][col];
        cell.CellFormat.FillFormat.FillType = FillType.Solid;
        cell.CellFormat.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 240, 248, 255);
    }

Bisakah saya mengatur gaya batas sel?

Properti batas sel dapat diakses melalui properti cell.CellFormat.BorderLeft, BorderTop, BorderRight, dan BorderBottom. Lihat referensi API untuk daftar lengkap atribut format batas.