Hvordan legge til former i PowerPoint i .NET

Aspose.Slides FOSS for .NET støtter å legge til AutoShapes, Tables, Connectors og PictureFrames i presentasjonslysbilder. Alle formtyper legges til gjennom slide.Shapes-samlingen.

Steg-for-steg guide

Trinn 1: Installer pakken

dotnet add package Aspose.Slides.Foss

Verifiser installasjonen:

using Aspose.Slides.Foss;
Console.WriteLine("Ready");

Steg 2: Opprett en presentasjon

Bruk alltid Presentation med en using uttalelse.

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

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

Trinn 3: Legg til en AutoShape

slide.Shapes.AddAutoShape(shapeType, x, y, width, height) plasserer en form på den gitte posisjonen og størrelsen (alle i punkter). Bruk ShapeType‑konstanter for å velge formen.

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

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

// Rectangle
var rect = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 300, 100);
rect.AddTextFrame("Rectangle shape");

// Ellipse
var ellipse = slide.Shapes.AddAutoShape(ShapeType.Ellipse, 400, 50, 200, 100);
ellipse.AddTextFrame("Ellipse shape");

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

Steg 4: Legg til en tabell

slide.Shapes.AddTable(x, y, columnWidths, rowHeights) oppretter en tabell på den angitte posisjonen. Kolonnebredder og rad høyder er arrays av punktverdier.

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

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

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

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

// Set data rows
string[][] rows = {
    new[] { "Widget A", "120", "$2,400" },
    new[] { "Widget B", "85", "$1,700" },
};
for (int rowIdx = 0; rowIdx < rows.Length; rowIdx++)
    for (int col = 0; col < rows[rowIdx].Length; col++)
        table.Rows[rowIdx + 1][col].TextFrame.Text = rows[rowIdx][col];

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

Steg 5: Legg til en kobling

Koblinger knytter to former visuelt sammen. Opprett formene først, deretter legg til en kobling og angi start‑ og sluttkoblingspunktene.

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

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

var box1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 100, 150, 60);
box1.AddTextFrame("Start");

var box2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 350, 100, 150, 60);
box2.AddTextFrame("End");

var conn = slide.Shapes.AddConnector(ShapeType.BentConnector3, 0, 0, 10, 10);
conn.StartShapeConnectedTo = box1;
conn.StartShapeConnectionSiteIndex = 3;  // right side of box1
conn.EndShapeConnectedTo = box2;
conn.EndShapeConnectionSiteIndex = 1;    // left side of box2

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

Tilkoblingsstedindekser er nummerert 0-3 for et rektangel: topp=0, venstre=1, bunn=2, høyre=3.

Trinn 6: Legg til en bildramme

Bytt inn et bilde og legg det til lysbildet som en PictureFrame. Les bildedataene først, legg dem til presentasjonens bildesamling, og opprett deretter rammen.

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

using var prs = new Presentation();
byte[] imageData = File.ReadAllBytes("logo.png");
var image = prs.Images.AddImage(imageData);

var slide = prs.Slides[0];
slide.Shapes.AddPictureFrame(
    ShapeType.Rectangle,  // bounding shape type
    50, 50,               // x, y in points
    200, 150,             // width, height in points
    image
);

prs.Save("with-image.pptx", SaveFormat.Pptx);

Vanlige problemer og løsninger

Figur vises utenfor det synlige lysbildeområdet

Lysbilder er som standard 720 × 540 poeng. Verdier av x eller y utenfor disse grensene plasserer formen utenfor lysbildet. Behold x < 720 og y < 540, og sørg for x + width <= 720 og y + height <= 540.

NullReferenceException ved tilgang til TextFrame

AddAutoShape() returnerer shape-objektet direkte. Hvis du ser null, sjekk at du ikke forkaster returverdien.

Tabellcelletekst er tom etter tildeling

Den korrekte egenskapen er .TextFrame.Text (ikke .Text direkte på cellen). Få tilgang til celler som table.Rows[rowIndex][colIndex].TextFrame.Text = "value".

Ofte stilte spørsmål

Hvor mange former kan jeg legge til på et lysbilde?

Det er ingen bibliotekpålagt grense. Praktiske grenser avhenger av filstørrelse og gjengivelsesevnen til din mål‑PPTX‑viser.

Kan jeg endre en form sin posisjon etter at jeg har lagt den til?

Ja. Shape‑objektet som returneres av AddAutoShape() har X, Y, Width og Height egenskaper som du kan sette:

shape.X = 100;
shape.Y = 200;
shape.Width = 400;
shape.Height = 80;

Kan jeg angi fargen på figurens omriss (kant)?

Ja, via shape.LineFormat:

using Aspose.Slides.Foss.Drawing;
shape.LineFormat.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 200, 0, 0);

Er diagrammer støttet?

Nei. Diagrammer, SmartArt og OLE‑objekter er ikke implementert i denne utgaven.