PowerPoint Sunum Tablolarını .NET'te Yönet

Bu sayfa ne hakkında

Aspose.Slides for .NET ile PowerPoint slaytlarında tablolar oluşturun ve düzenleyin. Tablo iş akışlarınızı basitleştirecek sade C# kod örneklerini keşfedin.

Giriş

PowerPoint’teki tablolar, bilgiyi satır ve sütunlar halinde düzenler, böylece değerleri okumak ve karşılaştırmak daha kolay olur.

Aspose.Slides, sunumlarda tablo oluşturmanıza, güncellemenize ve yönetmenize olanak tanıyan Table sınıfını, ITable arayüzünü, Cell sınıfını, ICell arayüzünü ve diğer türleri sağlar.

Baştan Bir Tablo Oluşturma

Bir tabloyu konumunu, sütun genişliklerini ve satır yüksekliklerini belirterek oluşturun. Slayta ekledikten sonra hücre kenarlıklarını biçimlendirebilir, hücreleri birleştirebilir ve metin ekleyebilirsiniz.

Presentation sınıfının bir örneğini oluşturun.
Diziniyle slayta bir referans alın.
Punto cinsinden sütun genişlikleri dizisi tanımlayın.
Punto cinsinden satır yükseklikleri dizisi tanımlayın.
AddTable yöntemiyle slayta bir ITable nesnesi ekleyin.
Her bir ICell üzerinde dolaşarak üst, alt, sağ ve sol kenarlara biçimlendirme uygulayın.
Tablonun ilk satırındaki ilk iki hücreyi birleştirin.
Birleştirilmiş hücreye, TextFrame özelliğiyle erişin.
Birleştirilmiş hücreye metni ayarlayın.
Değiştirilen sunumu kaydedin.

Aşağıdaki örnek, (100, 50) punto konumunda üç sütun ve beş satırdan oluşan bir tablo oluşturur. 5 punto genişliğinde kırmızı kenarlıklar uygular, ilk satırdaki ilk iki hücreyi birleştirir ve sonucu table.pptx olarak kaydeder.

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

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

var columnWidths = new double[] { 50, 50, 50 };
var rowHeights = new double[] { 50, 30, 30, 30, 30 };
var table = slide.Shapes.AddTable(100, 50, columnWidths, rowHeights);

foreach (var row in table.Rows)
{
    foreach (var cell in row)
    {
        var cellFormat = cell.CellFormat;
        cellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
        cellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
        cellFormat.BorderTop.Width = 5;

        cellFormat.BorderBottom.FillFormat.FillType = FillType.Solid;
        cellFormat.BorderBottom.FillFormat.SolidFillColor.Color = Color.Red;
        cellFormat.BorderBottom.Width = 5;

        cellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
        cellFormat.BorderLeft.FillFormat.SolidFillColor.Color = Color.Red;
        cellFormat.BorderLeft.Width = 5;

        cellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
        cellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
        cellFormat.BorderRight.Width = 5;
    }
}

table.MergeCells(table[0, 0], table[1, 0], false);
table[0, 0].TextFrame.Text = "Merged Cells";

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

Standart Bir Tablo İçinde Numaralandırma

Standart bir tabloda hücre indeksleri sıfırdan başlar ve (sütun, satır) sırasını kullanır. İlk hücre (0, 0) olarak indekslenir.

Örneğin, 4 sütun ve 4 satır içeren bir tablodaki hücreler şu şekilde numaralandırılır:

(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)

Bu örnek, yukarıda gösterilen 4 × 4 tabloyu, sütun genişlikleri ve satır yükseklikleri 70 punto ve 5 punto genişliğinde kırmızı hücre kenarlıklarıyla oluşturur. Koordinatlar hücre indekslerini gösterir; örnek hücreleri boş bırakır ve tabloyu StandardTables_out.pptx olarak kaydeder.

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

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

var columnWidths = new double[] { 70, 70, 70, 70 };
var rowHeights = new double[] { 70, 70, 70, 70 };
var table = slide.Shapes.AddTable(100, 50, columnWidths, rowHeights);

foreach (var row in table.Rows)
{
    foreach (var cell in row)
    {
        var cellFormat = cell.CellFormat;
        cellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
        cellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
        cellFormat.BorderTop.Width = 5;

        cellFormat.BorderBottom.FillFormat.FillType = FillType.Solid;
        cellFormat.BorderBottom.FillFormat.SolidFillColor.Color = Color.Red;
        cellFormat.BorderBottom.Width = 5;

        cellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
        cellFormat.BorderLeft.FillFormat.SolidFillColor.Color = Color.Red;
        cellFormat.BorderLeft.Width = 5;

        cellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
        cellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
        cellFormat.BorderRight.Width = 5;
    }
}

presentation.Save("StandardTables_out.pptx", SaveFormat.Pptx);

Var Olan Bir Tabloya Erişme

Tablolar, bir slaydın şekil koleksiyonunda depolanır. Şekiller arasında dolaşarak bir tablo bulun, ardından ITable arayüzünü kullanarak hücrelerini okuyabilir veya güncelleyebilirsiniz.

Presentation sınıfını kullanarak sunumu yükleyin.
İndisiyle tabloyu içeren slayta bir referans alın.
IShape nesneleri arasında dolaşın ve bir tablo bulunduğunda durun. Slayt birden çok tablo içeriyorsa, ihtiyacınız olanı belirlemek için AlternativeText kullanın.
Hedef hücredeki metni güncelleyin.
Değiştirilen sunumu kaydedin.

Aşağıdaki örnek UpdateExistingTable.pptx dosyasını açar ve ilk slayttaki ilk tabloyu bulur. Hücreyi sütun 0, satır 1 konumunda New olarak ayarlar ve sonucu table1_out.pptx olarak kaydeder. Girişte en az bir slayt bulunmalı ve o slayttaki ilk tablo en az bir sütun ve iki satır içermelidir.

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

using var presentation = new Presentation("UpdateExistingTable.pptx");
var slide = presentation.Slides[0];
ITable? table = null;

foreach (var shape in slide.Shapes)
{
    if (shape is ITable candidateTable)
    {
        table = candidateTable;
        break;
    }
}

table![0, 1].TextFrame.Text = "New";

presentation.Save("table1_out.pptx", SaveFormat.Pptx);

Var olan bir tabloda bir satırı yeniden boyutlandırmak ve gerçek yüksekliğinin istenen minimumu aşmasının nedenini anlamak için Control Row Height bölümüne bakın.

Bir Metin Çerçevesine Sahip Hücreyi Bulma

Genel bir metin işleme kodu bir tablodan ITextFrame aldığında, sahibi olan ICell nesnesini elde etmek için ITextFrame.ParentCell özelliğini kullanın. Bir tablo hücresi metin çerçevesi için ITextFrame.ParentCell ayarlanmıştır ve ITextFrame.ParentShape null değerindedir, tablo kendisi bir şekil olsa bile.

Hücre koordinatları, yalnızca okunabilir ICell.FirstColumnIndex ve ICell.FirstRowIndex özellikleri aracılığıyla elde edilebilir. ITextFrame.ParentCell de yalnızca okunabilir: sahibine yönlendirme sağlar ancak sahipliği değiştirmez. Kullanımdan önce her zaman döndürülen hücrenin null olup olmadığını kontrol edin.

Tablo hücresi ve şekil sahiplerini, SmartArt düğümleriyle ilişkili şekilleri de içeren tam bir örnek için Search and Replace Text bölümüne bakın.

Bir Tablo İçinde Metni Hizalama

Bireysel tablo hücrelerinin dikey sabitlemesini ve metin yönünü kontrol edebilirsiniz. Bu bölümdeki örnek, ilk hücredeki metni ortalar ve 270 derece döndürür.

Presentation sınıfının bir örneğini oluşturun.
İndisiyle slayta bir referans alın.
Slayta bir ITable nesnesi ekleyin.
Tablodan bir ITextFrame nesnesine erişin.
İlk IParagraph nesnesine erişin ve onun metnini ve rengini ayarlayın.
Hücrenin TextAnchorType ve TextVerticalType özelliklerini ayarlayın.
Değiştirilen sunumu kaydedin.

Bu örnek, sütun genişlikleri 120 punto ve satır yükseklikleri 100 punto olan 4 × 4 bir tablo oluşturur. (0, 0) hücresindeki metni biçimlendirir, ilk satırdaki kalan hücrelere değerler ekler ve sonucu Vertical_Align_Text_out.pptx olarak kaydeder.

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

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

var columnWidths = new double[] { 120, 120, 120, 120 };
var rowHeights = new double[] { 100, 100, 100, 100 };
var table = slide.Shapes.AddTable(100, 50, columnWidths, rowHeights);
table[1, 0].TextFrame.Text = "10";
table[2, 0].TextFrame.Text = "20";
table[3, 0].TextFrame.Text = "30";

var cell = table[0, 0];
var paragraph = cell.TextFrame.Paragraphs[0];
var portion = paragraph.Portions[0];
portion.Text = "Text here";
portion.PortionFormat.FillFormat.FillType = FillType.Solid;
portion.PortionFormat.FillFormat.SolidFillColor.Color = Color.Black;

cell.TextAnchorType = TextAnchorType.Center;
cell.TextVerticalType = TextVerticalType.Vertical270;

presentation.Save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);

Tablo Düzeyinde Metin Biçimlendirmesini Ayarlama

SetTextFormat kullanarak bir tablodaki tüm hücrelere metin biçimlendirmesi uygulayabilirsiniz. Aşırı yüklemeleri, bölüm, paragraf ve metin çerçevesi biçimlendirmesini kabul eder, böylece tek tek hücrelerde dolaşmadan bu özellikleri ayarlayabilirsiniz.

Presentation sınıfını kullanarak sunumu yükleyin.
İndisiyle slayta bir referans alın.
Slayttan bir ITable nesnesine erişin.
Metin için FontHeight ayarlayın.
Alignment ve MarginRight ayarlarını yapın.
TextVerticalType ayarlayın.
Değiştirilen sunumu kaydedin.

Aşağıdaki örnek, ilk şekli tablo olan en az bir slayt içeren table.pptx dosyasını açar. Yazı tipini 25 punto olarak ayarlar, paragrafları 20 punto sağ kenar boşluğu ile sağa hizalar ve metni dikey yapar. Biçimlendirilmiş sunum result.pptx olarak kaydedilir.

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

using var presentation = new Presentation("table.pptx");
var slide = presentation.Slides[0];

var table = (ITable)slide.Shapes[0];

var portionFormat = new PortionFormat();
portionFormat.FontHeight = 25;
table.SetTextFormat(portionFormat);

var paragraphFormat = new ParagraphFormat();
paragraphFormat.Alignment = TextAlignment.Right;
paragraphFormat.MarginRight = 20;
table.SetTextFormat(paragraphFormat);

var textFrameFormat = new TextFrameFormat();
textFrameFormat.TextVerticalType = TextVerticalType.Vertical;
table.SetTextFormat(textFrameFormat);

presentation.Save("result.pptx", SaveFormat.Pptx);

Tablo Stil Özelliklerini Almak

StylePreset kullanarak bir tablonun önceden tanımlı stilini okuyabilir veya atayabilirsiniz. Bu örnek, bir tabloya TableStylePreset.DarkStyle1 uygular, önceden tanımlı adını yazdırır ve aynı stili ikinci tabloya atar. Her iki tablo da table-style.pptx içinde kaydedilir.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

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

var columnWidths = new double[] { 100, 150 };
var rowHeights = new double[] { 5, 5, 5 };
var table = slide.Shapes.AddTable(10, 10, columnWidths, rowHeights);
table.StylePreset = TableStylePreset.DarkStyle1;

var stylePreset = table.StylePreset;
Console.WriteLine($"Table style preset: {stylePreset}");

var anotherTable = slide.Shapes.AddTable(10, 100, columnWidths, rowHeights);
anotherTable.StylePreset = stylePreset;

presentation.Save("table-style.pptx", SaveFormat.Pptx);

Bir Tablonun En Boy Oranını Kilitleme

Bir tablonun en boy oranı, genişliğinin yüksekliğine oranıdır. Bu oranı tablo için kilitlemek üzere AspectRatioLocked kullanın.

Aşağıdaki örnek, ilk şekli tablo olan en az bir slayt içeren pres.pptx dosyasını açar. Mevcut kilit durumunu yazdırır, en boy oranı kilidini etkinleştirir, güncellenen durumu (True) yazar ve sonucu pres-out.pptx olarak kaydeder.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("pres.pptx");
var slide = presentation.Slides[0];

var table = (ITable)slide.Shapes[0];

Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

table.ShapeLock.AspectRatioLocked = true;
Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

presentation.Save("pres-out.pptx", SaveFormat.Pptx);

SSS

Bir tablo ve hücrelerindeki metin için sağdan sola (RTL) okuma yönünü etkinleştirebilir miyim?
Evet. Tablo, bir RightToLeft özelliği sunar ve paragraflar ParagraphFormat.RightToLeft özelliğine sahiptir. İkisini birlikte kullanmak, hücre içindeki doğru RTL sırasını ve renderlamayı sağlar.

Kullanıcıların son dosyada bir tabloyu taşımasını veya yeniden boyutlandırmasını nasıl engelleyebilirim?
shape locks kullanarak taşıma, yeniden boyutlandırma, seçim vb. işlemleri devre dışı bırakabilirsiniz. Bu kilitler tablolara da uygulanır.

Bir hücrenin içinde görüntüyü arka plan olarak eklemek destekleniyor mu?
Evet. Hücre için bir picture fill ayarlayabilirsiniz; seçilen moda (germe veya döşeme) göre görüntü hücre alanını kaplar.

PowerPoint Tablolarında .NET ile Satır ve Sütunları Yönetme