Hantera presentationstabeller i .NET

Vad den här sidan handlar om

Skapa och redigera tabeller i PowerPoint-bilder med Aspose.Slides för .NET. Upptäck enkla C#-kodexempel för att effektivisera dina tabellarbetsflöden.

Introduktion

En tabell i PowerPoint är ett effektivt sätt att visa och återge information. Informationen i ett rutnät av celler (ordnade i rader och kolumner) är enkel och lätt att förstå.

Aspose.Slides tillhandahåller klassen Table, gränssnittet ITable, klassen Cell, gränssnittet ICell och andra typer för att låta dig skapa, uppdatera och hantera tabeller i alla typer av presentationer.

Skapa en tabell från grunden

Skapa en instans av klassen Presentation.
Hämta en slids referens via dess index.
Definiera en array av columnWidth.
Definiera en array av rowHeight.
Lägg till ett ITable‑objekt på sliden via metoden AddTable.
Iterera genom varje ICell för att tillämpa formatering på den övre, nedre, högra och vänstra kanten.
Slå samman de två första cellerna i tabellens första rad.
Åtkom en ICell’s TextFrame.
Lägg till lite text i TextFrame.
Spara den modifierade presentationen.

Denna C#‑kod visar hur du skapar en tabell i en presentation:

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

// Skapar en Presentation-klass som representerar en PPTX-fil
Presentation pres = new Presentation();

// Hämtar den första sliden
ISlide sld = pres.Slides[0];

// Definierar kolumner med bredd och rader med höjd
double[] dblCols = { 50, 50, 50 };
double[] dblRows = { 50, 30, 30, 30, 30 };

// Lägger till en tabellform på sliden
ITable tbl = sld.Shapes.AddTable(100, 50, dblCols, dblRows);

// Ställer in kantformat för varje cell
for (int row = 0; row < tbl.Rows.Count; row++)
{
	for (int cell = 0; cell < tbl.Rows[row].Count; cell++)
	{
		tbl.Rows[row][cell].CellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderTop.Width = 5;

		tbl.Rows[row][cell].CellFormat.BorderBottom.FillFormat.FillType = (FillType.Solid);
		tbl.Rows[row][cell].CellFormat.BorderBottom.FillFormat.SolidFillColor.Color= Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderBottom.Width =5;

		tbl.Rows[row][cell].CellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderLeft.FillFormat.SolidFillColor.Color =Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderLeft.Width = 5;

		tbl.Rows[row][cell].CellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderRight.Width = 5;
	}
}
// Slår ihop cellerna 1 och 2 i rad 1
tbl.MergeCells(tbl.Rows[0][0], tbl.Rows[0][1], false);

// Lägger till text i den sammanslagna cellen
tbl.Rows[0][0].TextFrame.Text = "Merged Cells";

// Sparar presentationen till disk
pres.Save("table.pptx", SaveFormat.Pptx);

Numrering i en standardtabell

I en standardtabell är numreringen av celler enkel och nollbaserad. Den första cellen i en tabell har index 0,0 (kolumn 0, rad 0).

Till exempel numreras cellerna i en tabell med 4 kolumner och 4 rader på följande sätt:

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

Denna C#‑kod skapar den standardiserade 4 × 4‑tabellen som visas ovan och anger kantformatet för varje cell:

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

// Instansierar en Presentation-klass som representerar en PPTX-fil
using (Presentation pres = new Presentation())
{

    // Hämtar den första sliden
    ISlide sld = pres.Slides[0];

    // Definierar kolumner med bredder och rader med höjder
    double[] dblCols = { 70, 70, 70, 70 };
    double[] dblRows = { 70, 70, 70, 70 };

    // Lägger till en tabellform på sliden
    ITable tbl = sld.Shapes.AddTable(100, 50, dblCols, dblRows);

    // Ställer in kantformat för varje cell
    foreach (IRow row in tbl.Rows)
    {
        foreach (ICell cell in row)
        {
			cell.CellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderTop.Width = 5;

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

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

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

    // Sparar presentationen till disk
    pres.Save("StandardTables_out.pptx", SaveFormat.Pptx);
}

Åtkom en befintlig tabell

Skapa en instans av klassen Presentation.
Hämta en referens till sliden som innehåller tabellen via dess index.
Skapa ett ITable‑objekt och sätt det till null.
Iterera genom alla IShape‑objekt tills tabellen hittas.

Om du misstänker att sliden du arbetar med innehåller en enda tabell kan du helt enkelt kontrollera alla former som den innehåller. När en form identifieras som en tabell kan du typecasta den till ett Table-objekt. Men om sliden du arbetar med innehåller flera tabeller är det bättre att söka efter den tabell du behöver via dess AlternativeText.
Använd ITable-objektet för att arbeta med tabellen. I exemplen nedan lade vi till en ny rad i tabellen.
Spara den modifierade presentationen.

Denna C#‑kod visar hur du åtkommer och arbetar med en befintlig tabell:

using Aspose.Slides;

// Instansierar en Presentation-klass som representerar en PPTX-fil
using (Presentation pres = new Presentation("UpdateExistingTable.pptx"))
{
    // Hämtar den första sliden
    ISlide sld = pres.Slides[0];

    // Initierar TableEx till null
    ITable tbl = null;

    // Itererar genom formerna och sätter en referens till den hittade tabellen
    foreach (IShape shp in sld.Shapes)
        if (shp is ITable)
            tbl = (ITable)shp;

    // Sätter texten för den första kolumnen i den andra raden
    tbl[0, 1].TextFrame.Text = "New";

    // Sparar den modifierade presentationen till disk
    pres.Save("table1_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

Hitta cellen som äger en TextFrame

När generisk text‑bearbetningskod får en ITextFrame från en tabell, använd egenskapen ITextFrame.ParentCell för att hämta den ägande ICell. För en tabell‑cell‑TextFrame är ITextFrame.ParentCell satt och ITextFrame.ParentShape är null, även om tabellen själv är en form.

Cellkoordinaterna finns tillgängliga via de skrivskyddade egenskaperna ICell.FirstColumnIndex och ICell.FirstRowIndex. ITextFrame.ParentCell är också skrivskyddad: den ger navigering till ägaren men ändrar inte ägandet. Kontrollera alltid den returnerade cellen för null innan du använder den.

För ett komplett exempel som identifierar tabell‑cell‑ och formägare, inklusive former som är associerade med SmartArt‑noder, se Search and Replace Text.

Justera text i en tabell

Skapa en instans av klassen Presentation.
Hämta en slids referens via dess index.
Lägg till ett ITable‑objekt på sliden.
Åtkom ett ITextFrame‑objekt från tabellen.
Åtkom ITextFrame-objektets IParagraph.
Justera texten vertikalt.
Spara den modifierade presentationen.

Denna C#‑kod visar hur du justerar texten i en tabell:

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

// Skapar en instans av Presentation-klassen
Presentation presentation = new Presentation();

// Hämtar den första sliden
ISlide slide = presentation.Slides[0];

// Definierar kolumner med bredder och rader med höjder
double[] dblCols = { 120, 120, 120, 120 };
double[] dblRows = { 100, 100, 100, 100 };

// Lägger till tabellformen på sliden
ITable tbl = slide.Shapes.AddTable(100, 50, dblCols, dblRows);
tbl[1, 0].TextFrame.Text = "10";
tbl[2, 0].TextFrame.Text = "20";
tbl[3, 0].TextFrame.Text = "30";

// Hämtar textramen
ITextFrame txtFrame = tbl[0, 0].TextFrame;

// Skapar Paragraph-objektet för textramen
IParagraph paragraph = txtFrame.Paragraphs[0];

// Skapar Portion-objektet för stycket
IPortion portion = paragraph.Portions[0];
portion.Text = "Text here";
portion.PortionFormat.FillFormat.FillType = FillType.Solid;
portion.PortionFormat.FillFormat.SolidFillColor.Color = Color.Black;

// Justera texten vertikalt
ICell cell = tbl[0, 0];
cell.TextAnchorType = TextAnchorType.Center;
cell.TextVerticalType = TextVerticalType.Vertical270;

// Sparar presentationen till disk
presentation.Save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);

Ställ in textformatering på tabellnivå

Skapa en instans av Presentation‑klassen.
Hämta en slids referens via dess index.
Åtkom ett ITable‑objekt från sliden.
Ställ in FontHeight för texten.
Ställ in Alignment och MarginRight.
Ställ in TextVerticalType.
Spara den modifierade presentationen.

Denna C#‑kod visar hur du tillämpar dina föredragna formateringsalternativ på texten i en tabell:

using Aspose.Slides;

// Skapar en instans av Presentation-klassen
Presentation presentation = new Presentation();
ISlide slide = presentation.Slides[0];

ITable someTable = presentation.Slides[0].Shapes[0] as ITable; // Anta att den första formen på den första bilden är en tabell

// Ställer in cellernas teckenhöjd
PortionFormat portionFormat = new PortionFormat();
portionFormat.FontHeight = 25;
someTable.SetTextFormat(portionFormat);

// Ställer in cellernas textjustering och högermarginal i ett anrop
ParagraphFormat paragraphFormat = new ParagraphFormat();
paragraphFormat.Alignment = TextAlignment.Right;
paragraphFormat.MarginRight = 20;
someTable.SetTextFormat(paragraphFormat);

// Ställer in cellernas vertikala texttyp
TextFrameFormat textFrameFormat = new TextFrameFormat();
textFrameFormat.TextVerticalType = TextVerticalType.Vertical;
someTable.SetTextFormat(textFrameFormat);


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

Hämta tabellstilsattribut

Aspose.Slides låter dig hämta stilattribut för en tabell så att du kan använda dessa detaljer för en annan tabell eller någon annanstans. Denna C#‑kod visar hur du får stilattributen från en tabellförinställd stil:

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

using (Presentation pres = new Presentation())
{
    ITable table = pres.Slides[0].Shapes.AddTable(10, 10, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    table.StylePreset = TableStylePreset.DarkStyle1; // ändra standardstilens förinställning

    // Hämta stilens förinställning för tabellen.
    TableStylePreset stylePreset = table.StylePreset;
    Console.WriteLine($"Table style preset: {stylePreset}");

    // Applicera den hämtade stilförinställningen på en annan tabell.
    ITable anotherTable = pres.Slides[0].Shapes.AddTable(10, 100, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    anotherTable.StylePreset = stylePreset;

    pres.Save("table.pptx", SaveFormat.Pptx);
}

Lås bildförhållandet för en tabell

Bildförhållandet för en geometrisk form är förhållandet mellan dess mått i olika dimensioner. Aspose.Slides tillhandahåller egenskapen AspectRatioLocked för att låsa inställningen av bildförhållandet för tabeller och andra former.

Denna C#‑kod visar hur du låser bildförhållandet för en tabell:

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

using (Presentation pres = new Presentation("pres.pptx"))
{
    ITable table = (ITable)pres.Slides[0].Shapes[0];
    Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

    table.ShapeLock.AspectRatioLocked = !table.ShapeLock.AspectRatioLocked; // vänd

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

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

FAQ

Kan jag aktivera läsriktning från höger till vänster (RTL) för en hel tabell och texten i dess celler?

Ja. Tabellen exponerar en RightToLeft‑egenskap, och stycken har ParagraphFormat.RightToLeft. Genom att använda båda säkerställer du korrekt RTL‑ordning och rendering i cellerna.

Hur kan jag förhindra att användare flyttar eller ändrar storlek på en tabell i den slutliga filen?

Använd shape locks för att inaktivera flytt, storleksändring, markering osv. Dessa lås gäller även för tabeller.

Stöds det att infoga en bild i en cell som bakgrund?

Ja. Du kan ange en picture fill för en cell; bilden täcker cellområdet enligt valt läge (stretch eller tile).

Hantera rader och kolumner i PowerPoint‑tabeller i .NET