Як додати форми до PowerPoint у .NET

Aspose.Slides FOSS for .NET підтримує додавання AutoShapes, Tables, Connectors та PictureFrames до слайдів презентації. Усі типи фігур додаються через колекцію slide.Shapes.

Покроковий посібник

Крок 1: Встановити пакет

dotnet add package Aspose.Slides.Foss

Перевірте встановлення:

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

Крок 2: Створити презентацію

Завжди використовуйте Presentation з using заявою.

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

Крок 3: Додати AutoShape

slide.Shapes.AddAutoShape(shapeType, x, y, width, height) розміщує форму у заданій позиції та розмірі (всі у пунктах). Використовуйте константи ShapeType для вибору форми.

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

Крок 4: Додати таблицю

slide.Shapes.AddTable(x, y, columnWidths, rowHeights) створює таблицю у вказаній позиції. Ширини стовпців та висоти рядків є масивами значень у пунктах.

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

Крок 5: Додати з’єднувач

З’єднувачі візуально з’єднують дві форми. Спочатку створіть форми, потім додайте з’єднувач і встановіть його початкову та кінцеву точки підключення.

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

Індекси точок підключення нумеруються від 0 до 3 для прямокутника: верх=0, ліво=1, низ=2, право=3.

Крок 6: Додати рамку для зображення

Вставте зображення та додайте його до слайду як PictureFrame. Спочатку прочитайте байти зображення, додайте їх до колекції зображень презентації, потім створіть кадр.

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

Поширені проблеми та виправлення

Форма з’являється за межами видимої області слайду

Слайди за замовчуванням мають розмір 720 × 540 пунктів. Значення x або y, що виходять за ці межі, розташовують форму поза слайдом. Збережіть x < 720 і y < 540, і забезпечте x + width <= 720 і y + height <= 540.

NullReferenceException при доступі до TextFrame

AddAutoShape() повертає об’єкт форми безпосередньо. Якщо ви бачите null, перевірте, що ви не відкидаєте повернене значення.

Текст клітинки таблиці порожній після присвоєння

Правильна властивість — .TextFrame.Text (не .Text безпосередньо на клітинці). Доступ до клітинок здійснюється як table.Rows[rowIndex][colIndex].TextFrame.Text = "value".

Поширені запитання

Скільки фігур я можу додати до слайду?

Немає обмеження, накладеного бібліотекою. Практичні обмеження залежать від розміру файлу та можливостей рендерингу вашого цільового переглядача PPTX.

Чи можу я змінити позицію форми після її додавання?

Так. Об’єкт форми, який повертається AddAutoShape(), має властивості X, Y, Width та Height, які ви можете встановити:

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

Чи можу я задати колір контуру (рамки) форми?

Так, через shape.LineFormat:

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

Чи підтримуються діаграми?

Ні. Діаграми, SmartArt та OLE‑об’єкти не реалізовані в цьому випуску.